Powershell-Modules
/
NTFSSecurity-Module
mirror of https://github.com/raandree/NTFSSecurity
1
0
Fork 0
Code Issues 0 Releases 3 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
13 Commits
3 Branches
74 MiB
 
 
Tree: fbb53f18bc
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'fbb53f18bc'
${ noResults }
NTFSSecurity-Module/AlphaFS/Filesystem/Native Methods/NativeMethods.Shell32.cs

198 lines
14 KiB
Raw Blame History 

  1. /*  Copyright (C) 2008-2016 Peter Palotas, Jeffrey Jangli, Alexandr Normuradov

  2.  *  

  3.  *  Permission is hereby granted, free of charge, to any person obtaining a copy 

  4.  *  of this software and associated documentation files (the "Software"), to deal 

  5.  *  in the Software without restriction, including without limitation the rights 

  6.  *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 

  7.  *  copies of the Software, and to permit persons to whom the Software is 

  8.  *  furnished to do so, subject to the following conditions:

  9.  *  

  10.  *  The above copyright notice and this permission notice shall be included in 

  11.  *  all copies or substantial portions of the Software.

  12.  *  

  13.  *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 

  14.  *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 

  15.  *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 

  16.  *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 

  17.  *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 

  18.  *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 

  19.  *  THE SOFTWARE. 

  20.  */

  21. 

  22. using System;

  23. using System.Diagnostics.CodeAnalysis;

  24. using System.IO;

  25. using System.Runtime.InteropServices;

  26. using System.Security;

  27. using System.Text;

  28. 

  29. namespace Alphaleonis.Win32.Filesystem

  30. {

  31.    internal static partial class NativeMethods

  32.    {

  33.       #region AssocXxx

  34. 

  35.       /// <summary>Returns a pointer to an IQueryAssociations object.</summary>

  36.       /// <returns>If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.</returns>

  37.       /// <remarks>Minimum supported client: Windows 2000 Professional, Windows XP [desktop apps only]</remarks>

  38.       /// <remarks>Minimum supported server: Windows 2000 Server [desktop apps only]</remarks>

  39.       [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]

  40.       [DllImport("shlwapi.dll", SetLastError = true, CharSet = CharSet.Unicode), SuppressUnmanagedCodeSecurity]

  41.       [return: MarshalAs(UnmanagedType.U4)]

  42.       internal static extern uint AssocCreate(Guid clsid, ref Guid riid, [MarshalAs(UnmanagedType.Interface)] out IQueryAssociations ppv);

  43. 

  44.       /// <summary>Searches for and retrieves a file or protocol association-related string from the registry.</summary>

  45.       /// <returns>Return value Type: HRESULT. Returns a standard COM error value, including the following: S_OK, E_POINTER and S_FALSE.</returns>

  46.       /// <remarks>Minimum supported client: Windows 2000 Professional</remarks>

  47.       /// <remarks>Minimum supported server: Windows 2000 Server</remarks>

  48.       [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]

  49.       [DllImport("shlwapi.dll", SetLastError = true, CharSet = CharSet.Unicode, EntryPoint = "AssocQueryStringW"), SuppressUnmanagedCodeSecurity]

  50.       [return: MarshalAs(UnmanagedType.U4)]

  51.       internal static extern uint AssocQueryString(Shell32.AssociationAttributes flags, Shell32.AssociationString str, [MarshalAs(UnmanagedType.LPWStr)] string pszAssoc, [MarshalAs(UnmanagedType.LPWStr)] string pszExtra, StringBuilder pszOut, [MarshalAs(UnmanagedType.U4)] out uint pcchOut);

  52. 

  53. 

  54.       #region IQueryAssociations

  55. 

  56.       internal static readonly Guid ClsidQueryAssociations = new Guid("A07034FD-6CAA-4954-AC3F-97A27216F98A");

  57.       internal const string QueryAssociationsGuid = "C46CA590-3C3F-11D2-BEE6-0000F805CA57";

  58. 

  59.       /// <summary>Exposes methods that simplify the process of retrieving information stored in the registry in association with defining a file type or protocol and associating it with an application.</summary>

  60.       [Guid(QueryAssociationsGuid), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]

  61.       [SuppressUnmanagedCodeSecurity]

  62.       internal interface IQueryAssociations

  63.       {

  64.          /// <summary>Initializes the IQueryAssociations interface and sets the root key to the appropriate ProgID.</summary>

  65.          /// <returns>If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.</returns>

  66.          /// <remarks>Minimum supported client: Windows 2000 Professional, Windows XP [desktop apps only]</remarks>

  67.          /// <remarks>Minimum supported server: Windows 2000 Server [desktop apps only]</remarks>

  68.          void Init(Shell32.AssociationAttributes flags, [MarshalAs(UnmanagedType.LPWStr)] string pszAssoc, IntPtr hkProgid, IntPtr hwnd);

  69. 

  70.          //[return: MarshalAs(UnmanagedType.U4)]

  71.          //uint Init(Shell32.AssociationAttributes flags, [MarshalAs(UnmanagedType.LPWStr)] string pszAssoc, IntPtr hkProgid, IntPtr hwnd);

  72. 

  73.          /// <summary>Searches for and retrieves a file or protocol association-related string from the registry.</summary>

  74.          /// <returns>A standard COM error value, including the following: S_OK, E_POINTER, S_FALSE</returns>

  75.          /// <remarks>Minimum supported client: Windows 2000 Professional, Windows XP [desktop apps only]</remarks>

  76.          /// <remarks>Minimum supported server: Windows 2000 Server [desktop apps only]</remarks>

  77.          void GetString(Shell32.AssociationAttributes flags, Shell32.AssociationString str, [MarshalAs(UnmanagedType.LPWStr)] string pwszExtra, StringBuilder pwszOut, [MarshalAs(UnmanagedType.I4)] out int pcchOut);

  78. 

  79.          //[return: MarshalAs(UnmanagedType.U4)]

  80.          //void GetString(Shell32.AssociationAttributes flags, Shell32.AssociationString str, [MarshalAs(UnmanagedType.LPWStr)] string pwszExtra, StringBuilder pwszOut, [MarshalAs(UnmanagedType.I4)] out int pcchOut);

  81. 

  82.          ///// <summary>Searches for and retrieves a file or protocol association-related key from the registry.</summary>

  83.          ///// <returns>If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.</returns>

  84.          ///// <remarks>Minimum supported client: Windows 2000 Professional, Windows XP [desktop apps only]</remarks>

  85.          ///// <remarks>Minimum supported server: Windows 2000 Server [desktop apps only]</remarks>

  86.          //[return: MarshalAs(UnmanagedType.U4)]

  87.          //uint GetKey(Shell32.AssociationAttributes flags, Shell32.AssociationKey str, [MarshalAs(UnmanagedType.LPWStr)] string pwszExtra, out UIntPtr phkeyOut);

  88. 

  89.          ///// <summary>Searches for and retrieves file or protocol association-related binary data from the registry.</summary>

  90.          ///// <returns>If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.</returns>

  91.          ///// <remarks>Minimum supported client: Windows 2000 Professional, Windows XP [desktop apps only]</remarks>

  92.          ///// <remarks>Minimum supported server: Windows 2000 Server [desktop apps only]</remarks>

  93.          //[return: MarshalAs(UnmanagedType.U4)]

  94.          //uint GetData(Shell32.AssociationAttributes flags, Shell32.AssociationData data, [MarshalAs(UnmanagedType.LPWStr)] string pwszExtra, [MarshalAs(UnmanagedType.LPArray, SizeParamIndex = 4)] out byte[] pvOut, [MarshalAs(UnmanagedType.I4)] out int pcbOut);

  95. 

  96.          ///// <summary>This method is not implemented.</summary>

  97.          //void GetEnum();

  98.       }

  99. 

  100.       #endregion // IQueryAssociations

  101. 

  102.       #endregion // AssocXxx

  103. 

  104. 

  105.       #region Path

  106. 

  107.       /// <summary>Determines whether a path to a file system object such as a file or folder is valid.</summary>

  108.       /// <returns><see langword="true"/> if the file exists; otherwise, <see langword="false"/>. Call GetLastError for extended error information.</returns>

  109.       /// <remarks>

  110.       /// This function tests the validity of the path.

  111.       /// A path specified by Universal Naming Convention (UNC) is limited to a file only; that is, \\server\share\file is permitted.

  112.       /// A network share path to a server or server share is not permitted; that is, \\server or \\server\share.

  113.       /// This function returns FALSE if a mounted remote drive is out of service.

  114.       /// </remarks>

  115.       /// <remarks>Minimum supported client: Windows 2000 Professional</remarks>

  116.       /// <remarks>Minimum supported server: Windows 2000 Server</remarks>

  117.       [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]

  118.       [DllImport("Shlwapi.dll", SetLastError = true, CharSet = CharSet.Unicode, EntryPoint = "PathFileExistsW"), SuppressUnmanagedCodeSecurity]

  119.       [return: MarshalAs(UnmanagedType.Bool)]

  120.       internal static extern bool PathFileExists([MarshalAs(UnmanagedType.LPWStr)] string pszPath);

  121. 

  122. 

  123.       /// <summary>Converts a file URL to a Microsoft MS-DOS path.</summary>

  124.       /// <returns>Type: HRESULT

  125.       /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

  126.       /// </returns>

  127.       /// <remarks>Minimum supported client: Windows 2000 Professional, Windows XP [desktop apps only]</remarks>

  128.       /// <remarks>Minimum supported server: Windows 2000 Server [desktop apps only]</remarks>

  129.       [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]

  130.       [DllImport("shlwapi.dll", SetLastError = true, CharSet = CharSet.Unicode, EntryPoint = "PathCreateFromUrlW"), SuppressUnmanagedCodeSecurity]

  131.       [return: MarshalAs(UnmanagedType.U4)]

  132.       internal static extern uint PathCreateFromUrl([MarshalAs(UnmanagedType.LPWStr)] string pszUrl, StringBuilder pszPath, [MarshalAs(UnmanagedType.U4)] ref uint pcchPath, [MarshalAs(UnmanagedType.U4)] uint dwFlags);

  133. 

  134. 

  135.       /// <summary>Creates a path from a file URL.</summary>

  136.       /// <returns>Type: HRESULT

  137.       /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

  138.       /// </returns>

  139.       /// <remarks>Minimum supported client: Windows Vista [desktop apps only]</remarks>

  140.       /// <remarks>Minimum supported server: Windows Server 2008 [desktop apps only]</remarks>

  141.       [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]

  142.       [DllImport("shlwapi.dll", SetLastError = true, CharSet = CharSet.Unicode), SuppressUnmanagedCodeSecurity]

  143.       [return: MarshalAs(UnmanagedType.U4)]

  144.       internal static extern uint PathCreateFromUrlAlloc([MarshalAs(UnmanagedType.LPWStr)] string pszIn, out StringBuilder pszPath, [MarshalAs(UnmanagedType.U4)] uint dwFlags);

  145. 

  146. 

  147.       /// <summary>Converts a Microsoft MS-DOS path to a canonicalized URL.</summary>

  148.       /// <returns>Type: HRESULT

  149.       /// Returns S_FALSE if pszPath is already in URL format. In this case, pszPath will simply be copied to pszUrl.

  150.       /// Otherwise, it returns S_OK if successful or a standard COM error value if not.

  151.       /// </returns>

  152.       /// <remarks>

  153.       /// UrlCreateFromPath does not support extended paths. These are paths that include the extended-length path prefix "\\?\".

  154.       /// </remarks>

  155.       /// <remarks>Minimum supported client: Windows 2000 Professional, Windows XP [desktop apps only]</remarks>

  156.       /// <remarks>Minimum supported server: Windows 2000 Server [desktop apps only]</remarks>

  157.       [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]

  158.       [DllImport("shlwapi.dll", SetLastError = true, CharSet = CharSet.Unicode, EntryPoint = "UrlCreateFromPathW"), SuppressUnmanagedCodeSecurity]

  159.       [return: MarshalAs(UnmanagedType.U4)]

  160.       internal static extern uint UrlCreateFromPath([MarshalAs(UnmanagedType.LPWStr)] string pszPath, StringBuilder pszUrl, ref uint pcchUrl, [MarshalAs(UnmanagedType.U4)] uint dwFlags);

  161. 

  162. 

  163.       /// <summary>Tests whether a URL is a specified type.</summary>

  164.       /// <returns>

  165.       /// Type: BOOL

  166.       /// For all but one of the URL types, UrlIs returns <see langword="true"/> if the URL is the specified type, <see langword="true"/> otherwise.

  167.       /// If UrlIs is set to <see cref="Shell32.UrlType.IsAppliable"/>, UrlIs will attempt to determine the URL scheme.

  168.       /// If the function is able to determine a scheme, it returns <see langword="true"/>, or <see langword="false"/>.

  169.       /// </returns>

  170.       /// <remarks>Minimum supported client: Windows 2000 Professional, Windows XP [desktop apps only]</remarks>

  171.       /// <remarks>Minimum supported server: Windows 2000 Server [desktop apps only]</remarks>

  172.       [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]

  173.       [DllImport("shlwapi.dll", SetLastError = true, CharSet = CharSet.Unicode, EntryPoint = "UrlIsW"), SuppressUnmanagedCodeSecurity]

  174.       [return: MarshalAs(UnmanagedType.Bool)]

  175.       internal static extern bool UrlIs([MarshalAs(UnmanagedType.LPWStr)] string pszUrl, Shell32.UrlType urlIs);

  176. 

  177.       #endregion // Path

  178. 

  179. 

  180.       /// <summary>Destroys an icon and frees any memory the icon occupied.</summary>

  181.       /// <remarks>Minimum supported client: Windows XP [desktop apps only]</remarks>

  182.       /// <remarks>Minimum supported server: Windows 2000 Server [desktop apps only]</remarks>

  183.       [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]

  184.       [DllImport("user32.dll", SetLastError = false)]

  185.       [return: MarshalAs(UnmanagedType.Bool)]

  186.       internal static extern bool DestroyIcon(IntPtr hIcon);

  187. 

  188. 

  189.       /// <summary>Retrieves information about an object in the file system, such as a file, folder, directory, or drive root.</summary>

  190.       /// <remarks>You should call this function from a background thread. Failure to do so could cause the UI to stop responding.</remarks>

  191.       /// <remarks>Minimum supported client: Windows 2000 Professional [desktop apps only]</remarks>

  192.       /// <remarks>Minimum supported server: Windows 2000 Server [desktop apps only]</remarks>

  193.       [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]

  194.       [DllImport("shell32.dll", SetLastError = true, CharSet = CharSet.Unicode, EntryPoint = "SHGetFileInfoW"), SuppressUnmanagedCodeSecurity]

  195.       internal static extern IntPtr ShGetFileInfo([MarshalAs(UnmanagedType.LPWStr)] string pszPath, FileAttributes dwFileAttributes, [MarshalAs(UnmanagedType.Struct)] out Shell32.FileInfo psfi, [MarshalAs(UnmanagedType.U4)] uint cbFileInfo, [MarshalAs(UnmanagedType.U4)] Shell32.FileAttributes uFlags);

  196.    }

  197. }