using System; using System.Runtime.InteropServices; using System.Runtime.InteropServices.ComTypes; using System.Security; using Vanara.Extensions; using Vanara.InteropServices; using static Vanara.PInvoke.Ole32; using static Vanara.PInvoke.PropSys; namespace Vanara.PInvoke { public static partial class Shell32 { /// The bind interruptible public const uint BIND_INTERRUPTABLE = 0xFFFFFFFF; /// /// Introduced in Windows XP SP2. Specify this bind context to permit clients of the data source to override the hidden drive letter /// policy and enable access to the view objects for data sources on the drives that are blocked. /// Used with IShellFolder::BindToObject or IShellItem::BindToHandler. /// /// The system supports administrator-controlled policies that hide specified drive letters to block users from accessing those /// drives through Windows Explorer.When this policy is active, the result is that view objects and other handlers created with the /// IShellFolder::CreateViewObject method will fail when called on drives that are blocked by policy. /// /// public const string STR_AVOID_DRIVE_RESTRICTION_POLICY = "Avoid Drive Restriction Policy"; /// /// Introduced in Windows Vista. Specify this bind context to cause the IShellFolder::BindToObject method to use the object specified /// by the pbc parameter to create the target object; in this case, the object specified by the punk parameter in the /// IBindCtx::RegisterObjectParam call must implement the ICreateObject interface. /// Used with IShellFolder::BindToObject or IShellItem::BindToHandler. /// public const string STR_BIND_DELEGATE_CREATE_OBJECT = "Delegate Object Creation"; /// /// Introduced in Windows 7. Passed to IShellFolder::ParseDisplayName with an FOLDER_ENUM_MODE value to control the enumeration mode /// of the parsed item. The FOLDER_ENUM_MODE value is passed in the bind context through an object that implements IObjectWithFolderEnumMode. /// /// Items with different enumeration modes compare canonically(SHCIDS_CANONICALONLY) different because they enumerate different sets /// of items. /// /// /// If an item doesn't support the enumeration mode (because it isn't a folder or it doesn't provide the enumeration mode) then it is /// created in the default enumeration mode. /// /// public const string STR_BIND_FOLDER_ENUM_MODE = "Folder Enum Mode"; /// /// Introduced in Windows 7. Passed to IShellFolder::ParseDisplayName along with STR_FILE_SYS_BIND_DATA. This forces simple parsing /// while also probing for Desktop.ini files along the path from which to get a localized name string. This avoids probing for /// folders along the path, which, in a case of a folder that represents a server or a share, could take extensive time and /// resources. Desktop.ini files are cached in some locations, so it will be at least as efficient as probing for folders attributes /// and then probing for the Desktop.ini if that folder should turn ou tot be read-only. /// public const string STR_BIND_FOLDERS_READ_ONLY = "Folders As Read Only"; /// /// Introduced in Windows XP SP2. Specify this bind context to force a folder shortcut to resolve the link that points to its target. /// /// A folder shortcut is a folder item that points to another folder item in the same namespace, using a link(shortcut) to hold the /// IDList of the target.The link is resolved to track the target in case it is moved or renamed.For example, the Windows XP My /// Network Places folder and the Windows Vista Computer folder can contain folder shortcuts created with the Add Network Location /// wizard.To improve performance, the IShellFolder::BindToObject method does not resolve links to network folder by default. /// /// Used with IShellFolder::BindToObject or IShellItem::BindToHandler. /// public const string STR_BIND_FORCE_FOLDER_SHORTCUT_RESOLVE = "Force Folder Shortcut Resolve"; /// /// Introduced in Windows XP. Specify this bind context to prevent a call to the IShellFolder::ParseDisplayName method on the Desktop /// folder from treating relative paths as relative to the desktop; in such a case, parsing fails when this bind context is specified. /// public const string STR_DONT_PARSE_RELATIVE = "Don't Parse Relative"; /// /// Introduced in Windows Vista. Specify this bind context to instruct an IShellItem not to resolve the link target obtained when /// using the BHID_LinkTargetItem GUID in IShellItem::BindToHandler. /// public const string STR_DONT_RESOLVE_LINK = "Don't Resolve Link"; /// /// Introduced in Windows 8. Specifies a SHCONTF value to be passed to IShellFolder::EnumObjects when you call /// IShellItem::BindToHandler with BHID_EnumItems. /// public const string STR_ENUM_ITEMS_FLAGS = "SHCONTF"; /// /// Introduced in Windows XP. Specify this bind context to provide file metadata to the IShellFolder::ParseDisplayName method, which /// is used instead of attempting to retrieve the actual file metadata. The associated object must implement IFileSystemBindData and /// can optionally also implement IFileSystemBindData2. By default, the IShellFolder::ParseDisplayName method verifies that the file /// exists and uses the file's actual metadata to populate the ID list. /// public const string STR_FILE_SYS_BIND_DATA = "File System Bind Data"; /// /// Introduced in Windows 8.1. Specify this bind context to indicate that the data provided in the STR_FILE_SYS_FIND_DATA bind /// context should be used to create an ItemID list in the Windows 7 format. /// public const string STR_FILE_SYS_BIND_DATA_WIN7_FORMAT = "Win7FileSystemIdList"; /// /// Introduced in Windows 7. Specify this bind context when the handler is being retrieved on the same thread as the UI. Any /// memory-intensive activities such as those that involve disk or network access should be avoided. /// public const string STR_GET_ASYNC_HANDLER = "GetAsyncHandler"; /// /// Introduced in Windows Vista. Specify this bind context when requesting an IPropertySetStorage or IPropertyStore handler. This /// value is used with IShellFolder::BindToObject. See the GPS_BESTEFFORT flag for more information. /// public const string STR_GPS_BESTEFFORT = "GPS_BESTEFFORT"; /// /// Introduced in Windows Vista. Specify this bind context when requesting an IPropertySetStorage or IPropertyStore handler. This /// value is used with IShellFolder::BindToObject. See the GPS_DELAYCREATION flag for more information. /// public const string STR_GPS_DELAYCREATION = "GPS_DELAYCREATION"; /// /// Introduced in Windows Vista. Specify this bind context when requesting an IPropertySetStorage or IPropertyStore handler. This /// value is used with IShellFolder::BindToObject. See the GPS_FASTPROPERTIESONLY flag for more information. /// public const string STR_GPS_FASTPROPERTIESONLY = "GPS_FASTPROPERTIESONLY"; /// /// Introduced in Windows Vista. Specify this bind context when requesting an IPropertySetStorage or IPropertyStore handler. This /// value is used with IShellFolder::BindToObject. See the GPS_HANDLERPROPERTIESONLY flag for more information. /// public const string STR_GPS_HANDLERPROPERTIESONLY = "GPS_HANDLERPROPERTIESONLY"; /// /// Introduced in Windows 7. Specify this bind context when requesting an IPropertySetStorage or IPropertyStore handler. This value /// is used with IShellFolder::BindToObject. See the GPS_NO_OPLOCK flag for more information. /// public const string STR_GPS_NO_OPLOCK = "GPS_NO_OPLOCK"; /// /// Introduced in Windows Vista. Specify this bind context when requesting an IPropertySetStorage or IPropertyStore handler. This /// value is used with IShellFolder::BindToObject. See the GPS_OPENSLOWITEM flag for more information. /// public const string STR_GPS_OPENSLOWITEM = "GPS_OPENSLOWITEM"; /// /// Windows Vista only. Specify this bind context to cause a call to the IShellFolder::BindToObject method that requests the IFilter /// interface for a file system object to return a text filter if no other filter is available. This value is not defined as of /// Windows 7. /// public const string STR_IFILTER_FORCE_TEXT_FILTER_FALLBACK = "Always bind persistent handlers"; /// /// Windows Vista only. Specify this bind context to cause a call to the IShellFolder::BindToObject method that requests the IFilter /// interface for a file system object to not return a fallback filter if no registered filter could be found. /// public const string STR_IFILTER_LOAD_DEFINED_FILTER = "Only bind registered persistent handlers"; /// /// Introduced in Windows Vista. Specify this bind context to enable loading of the history from a stream for an internal navigation /// when the IPersistHistory::LoadHistory method is called. An internal navigation is a navigation within the same view. /// public const string STR_INTERNAL_NAVIGATE = "Internal Navigation"; /// /// Introduced in Windows 7. Specify this bind context with STR_PARSE_PREFER_FOLDER_BROWSING when the client wants the Internet Shell /// folder handlers to generate an IDList for any valid URL if a DAV-type folder cannot be created for that URL. The URL is not /// verified to exist; only its syntax is checked and that it has a registered protocol handler. /// public const string STR_INTERNETFOLDER_PARSE_ONLY_URLMON_BINDABLE = "Validate URL"; /// /// Introduced in Windows 7. Specify this bind context to instruct implementations of IShellFolder::ParseDisplayName and /// IPersistFolder3::InitializeEx to cache memory-intensive helper objects that can exist across instantiations of Shell items /// instead of recreating these objects each time that a Shell item is created. The associated object is another bind context object, /// initially empty. This should result in a separate bind context object, which is accessed through IBindCtx::GetObjectParam or IBindCtx::Register.ObjectParam. /// /// A caller must opt into this behavior by providing this bind context parameter when calling SHCreateItemFromParsingName. By doing /// so, you optimize the behavior of binding to multiple parsing names in succession.The lifetime of the bind context object should /// span multiple instances of Shell items and their individual bind contexts. /// /// public const string STR_ITEM_CACHE_CONTEXT = "ItemCacheContext"; /// /// Introduced in Windows Vista. Specify this bind context to allow invalid file name characters to appear in file names. By default, /// a call to the IShellFolder::ParseDisplayName method rejects characters that are illegal in file names. This bind context is /// meaningful only in conjunction with the STR_FILE_SYS_FIND_DATA bind context. /// public const string STR_NO_VALIDATE_FILENAME_CHARS = "NoValidateFilenameChars"; /// /// Introduced in Windows Vista. Specify this bind context to enable a call to the IShellFolder::ParseDisplayName method on the /// Desktop folder to parse URLs. If this bind context is specified, it overrides STR_PARSE_PREFER_WEB_BROWSING. /// public const string STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS = "Allow binding to Internet shell folder handlers and negate STR_PARSE_PREFER_WEB_BROWSING"; /// /// Introduced in Windows 7. Specify this bind context to instruct a data source's implementation of IShellFolder::ParseDisplayName /// to optimize the behavior of SHCreateItemFromParsingName. /// /// Normally, SHCreateItemFromParsingName performs two binding operations on the name to be parsed: one through and one to /// IShellFolder::ParseDisplayName and one to create the Shell item.When the STR_PARSE_AND_CREATE_ITEM bind context is supported, the /// second bind is avoided by creating the Shell item during the IShellFolder::ParseDisplayName bind and storing the Shell item /// through IParseAndCreateItem::SetItem.SHCreateItemFromParsingName then uses the stored Shell item rather than creating one. /// /// /// This parameter applies to the last element of the name that is parsed. For instance, in the name "C:\Folder1\File.txt, the data /// applies to File.txt. /// /// public const string STR_PARSE_AND_CREATE_ITEM = "ParseAndCreateItem"; /// /// Windows Vista only. Specify that, when parsing a URL, this bind context should not require the URL to exist before generating an /// IDList for it. Specify this bind context along with STR_PARSE_PREFER_FOLDER_BROWSING when the client desires that the Internet /// Shell folder handlers generate an IDList for the URL if a DAV folder cannot be created for the given URL. /// public const string STR_PARSE_DONT_REQUIRE_VALIDATED_URLS = "Do not require validated URLs"; /// /// Introduced in Windows 7. The IShellFolder::ParseDisplayName method sets this property to tell the caller that the returned IDList /// was bound to the ProgID specified with STR_PARSE_WITH_EXPLICIT_PROGID or the application specified with /// STR_PARSE_WITH_EXPLICIT_ASSOCAPP. When STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL is absent, the ProgID or application was not /// bound into the IDList. /// public const string STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL = "ExplicitAssociationSuccessful"; /// /// Introduced in Windows Vista. Specify this bind context to pass the original item that is being re-parsed when that item is stored /// as a IShellItem object that also implements the IParentAndItem interface. Before Windows 7 this value was not defined in a header /// file. It could be defined by the caller or passed as its string value of L"ParseOriginalItem". As of Windows 7, the value is /// defined in Shlobj.h. Note that this is a different header than the other STR constants. /// public const string STR_PARSE_PARTIAL_IDLIST = "ParseOriginalItem"; /// /// Introduced in Windows XP. Specify this bind context to enable a call to the IShellFolder::ParseDisplayName method on the Desktop /// folder to parse URLs as if they were folders. Use this bind context to bind to a WebDAV server. /// public const string STR_PARSE_PREFER_FOLDER_BROWSING = "Parse Prefer Folder Browsing"; /// /// Introduced in Windows Vista. Specify this bind context to prevent a call to the IShellFolder::ParseDisplayName method on the /// Desktop folder form parsing URLs. This bind context can be overridden by STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS. /// public const string STR_PARSE_PREFER_WEB_BROWSING = "Do not bind to Internet shell folder handlers"; /// /// Introduced in Windows Vista. Specify this bind context to override the default property store used by the /// IShellFolder::ParseDisplayName method, and use the property store specified as the bind parameter instead. Applies to delegate folders. /// public const string STR_PARSE_PROPERTYSTORE = "DelegateNamedProperties"; /// /// Introduced in Windows XP SP2. Specify this bind context to enable a call to the IShellFolder::ParseDisplayName method on the /// Desktop folder to use the "shell:" prefix notation to access files. /// public const string STR_PARSE_SHELL_PROTOCOL_TO_FILE_OBJECTS = "Parse Shell Protocol To File Objects"; /// /// Introduced in Windows Vista. Specify this bind context to cause a call to the IShellFolder::ParseDisplayName method to display /// the network diagnostics dialog if the parsing of a network path fails. /// public const string STR_PARSE_SHOW_NET_DIAGNOSTICS_UI = "Show network diagnostics UI"; /// /// Introduced in Windows Vista. Specify this bind context to cause a call to the IShellFolder::ParseDisplayName method to skip /// checking the network shares cache and contact the network server directly. Information about network shares is cached to improve /// performance, and IShellFolder::ParseDisplayName checks this cache by default. /// public const string STR_PARSE_SKIP_NET_CACHE = "Skip Net Resource Cache"; /// /// Introduced in Windows XP. Specify this bind context to pass parsed properties to the IShellFolder::ParseDisplayName method for a /// delegate namespace. The namespace can use the passed properties instead of attempting to parse the name itself. /// public const string STR_PARSE_TRANSLATE_ALIASES = "Parse Translate Aliases"; /// /// Introduced in Windows 7. Specify this property to cause a call to the IShellFolder::ParseDisplayName method to return an IDList /// bound to the file type association handler for the application. /// public const string STR_PARSE_WITH_EXPLICIT_ASSOCAPP = "ExplicitAssociationApp"; /// /// Introduced in Windows 7. Specify this property to cause a call to the IShellFolder::ParseDisplayName method to return an IDList /// bound to the file association handler of the provided ProgID. /// public const string STR_PARSE_WITH_EXPLICIT_PROGID = "ExplicitProgid"; /// /// Windows Vista only. A parsing bind context that is used to pass a set of properties and the item's name when calling /// IShellFolder::ParseDisplayName. The object in the bind context implements IPropertyStore and is retrieved by calling IBindCtx::GetObjectParam. /// /// DBFolder is a Shell data source that represents items in search results and query-based views.DBFolder retrieves these items by /// querying the Windows Search system.Items in the search results are identified through a protocol scheme, for example "file:" or /// "mapi:". DBFolder provides the behavior for these items by delegating to Shell data sources that are created for these protocols. /// See Developing Protocol Handler Add-ins for more information. /// /// /// When DBFolder delegates its parsing operation to the Shell data sources that support Windows Search protocols, this bind context /// provides access to values that were returned in the query result for that item. This includes the following: /// /// /// /// System.ItemType (PKEY_ItemType) /// /// /// System.ParsingPath (PKEY_ParsingPath) /// /// /// System.ItemPathDisplay (PKEY_ItemPathDisplay) /// /// /// System.ItemNameDisplay (PKEY_ItemNameDisplay) /// /// /// /// This bind context can also be used to parse a DBFolder item if a client has a set of properties that define the item.In this case /// an empty name should be passed to IShellFolder::ParseDisplayName. /// /// /// Before Windows 7, this value was not defined in a header file.It could be defined by the caller or passed as its string value: /// L"ParseWithProperties". As of Windows 7, the value is defined in Shlobj.h.Note that this is a different header than where the /// other STR constants are defined. /// /// public const string STR_PARSE_WITH_PROPERTIES = "ParseWithProperties"; /// /// Introduced in Windows 8. Specify this bind context to indicate that the bind context parameter is a property bag (IPropertyBag) /// used to pass VARIANT values in the bind context. See the Remarks section for further details. /// public const string STR_PROPERTYBAG_PARAM = "SHBindCtxPropertyBag"; /// The string referrer identifier public const string STR_REFERRER_IDENTIFIER = "Referrer Identifier"; /// /// Introduced in Windows XP. Specify this bind context to cause calls to the IShellFolder::ParseDisplayName or /// IShellFolder::BindToObject methods to ignore a particular Shell namespace extension when parsing or binding. The CLSID of the /// namespace to ignore is provided by the IPersist::GetClassID method of the bind parameter. /// public const string STR_SKIP_BINDING_CLSID = "Skip Binding CLSID"; /// The string tab reuse identifier public const string STR_TAB_REUSE_IDENTIFIER = "Tab Reuse Identifier"; /// Not used. public const string STR_TRACK_CLSID = "Track the CLSID"; /// Values that specify from which category the list of destinations should be retrieved. [PInvokeData("Shobjidl.h", MSDNShortId = "dd378410")] public enum APPDOCLISTTYPE { /// The Recent category, which lists those items most recently accessed. RECENT, /// The Frequent category, which lists the items that have been accessed the greatest number of times. FREQUENT } /// The type of media in a given drive. [PInvokeData("shobjidl.h", MSDNShortId = "ebc826a2-d7ea-413a-836b-c7e51f13692a")] [Flags] public enum ARCONTENT { /// Use the Autorun.inf file. This is the traditional AutoRun behavior. ARCONTENT_AUTORUNINF = 0x00000002, /// AutoRun audio CDs. ARCONTENT_AUDIOCD = 0x00000004, /// AutoRun DVDs. ARCONTENT_DVDMOVIE = 0x00000008, /// AutoPlay blank CD-Rs and CD-RWs. ARCONTENT_BLANKCD = 0x00000010, /// AutoPlay blank DVD-Rs and DVD-RAMs. ARCONTENT_BLANKDVD = 0x00000020, /// AutoRun if the media is formatted and the content does not fall under a type covered by one of the other flags. ARCONTENT_UNKNOWNCONTENT = 0x00000040, /// AutoPlay if the content consists of file types defined as pictures, such as .bmp and .jpg files. ARCONTENT_AUTOPLAYPIX = 0x00000080, /// AutoPlay if the content consists of file types defined as music, such as MP3 files. ARCONTENT_AUTOPLAYMUSIC = 0x00000100, /// AutoPlay if the content consists of file types defined as video files. ARCONTENT_AUTOPLAYVIDEO = 0x00000200, /// Introduced in Windows Vista. AutoPlay video CDs (VCDs). ARCONTENT_VCD = 0x00000400, /// Introduced in Windows Vista. AutoPlay Super Video CD (SVCD) media. ARCONTENT_SVCD = 0x00000800, /// Introduced in Windows Vista. AutoPlay DVD-Audio media. ARCONTENT_DVDAUDIO = 0x00001000, /// /// AutoPlay blank recordable high definition DVD media in the Blu-ray Disc™ format (BD-R or BD-RW). Note: Prior to Windows 7, /// this value was defined to specify non-recordable media in the HD DVD format. /// ARCONTENT_BLANKBD = 0x00002000, /// Introduced in Windows Vista. AutoPlay high definition DVD media in the Blu-ray Disc™ format. ARCONTENT_BLURAY = 0x00004000, /// Introduced in Windows 8. ARCONTENT_CAMERASTORAGE = 0x00008000, /// Introduced in Windows 8. ARCONTENT_CUSTOMEVENT = 0x00010000, /// Introduced in Windows Vista. AutoPlay empty but formatted media. ARCONTENT_NONE = 0x00000000, /// /// Introduced in Windows Vista. A mask that denotes valid ARCONTENT flag values for media types. This mask does not include /// ARCONTENT_PHASE values. /// ARCONTENT_MASK = 0x0001FFFE, /// /// Introduced in Windows Vista. AutoPlay is searching the media. The phase of the search (presniff, sniffing, or final) is unknown. /// ARCONTENT_PHASE_UNKNOWN = 0x00000000, /// /// Introduced in Windows Vista. The contents of the media are known before the media is searched, due to the media type; for /// instance, audio CDs and DVD movies. /// ARCONTENT_PHASE_PRESNIFF = 0x10000000, /// /// Introduced in Windows Vista. AutoPlay is currently searching the media. Any results reported during this phase should be /// considered a partial list as more content types might still be found. /// ARCONTENT_PHASE_SNIFFING = 0x20000000, /// Introduced in Windows Vista. AutoPlay has finished searching the media. Results reported are final. ARCONTENT_PHASE_FINAL = 0x40000000, /// Introduced in Windows Vista. A mask that denotes valid ARCONTENT_PHASE values. ARCONTENT_PHASE_MASK = 0x70000000, } /// Specifies the enumeration handler filter applied to the full list of handlers in SHAssocEnumHandlers. [PInvokeData("shobjidl_core.h", MSDNShortId = "83db466b-e00c-4015-879f-c5c222f45b8c")] public enum ASSOC_FILTER { /// Return all handlers. ASSOC_FILTER_NONE = 0x0, /// /// Return only recommended handlers. A handler sets its recommended status in the registry when it is installed. An initial /// status of non-recommended can later be promoted to recommended as a result of user action. /// ASSOC_FILTER_RECOMMENDED = 0x1, } /// /// /// Specifies the source of the default association for a file name extension. Used by methods of the /// IApplicationAssociationRegistration interface. /// /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/ne-shobjidl_core-associationlevel typedef enum ASSOCIATIONLEVEL // { AL_MACHINE , AL_EFFECTIVE , AL_USER } ; [PInvokeData("shobjidl_core.h", MSDNShortId = "846ce9f4-092a-420d-be73-0951efc4368f")] public enum ASSOCIATIONLEVEL { /// The machine-level default application association. AL_MACHINE, /// The effective default for the current user. This value should be used by most applications. AL_EFFECTIVE, /// /// The per-user default application association. If this value is used and no per-user default is declared, the calling method /// fails with a value of . /// AL_USER, } /// /// Specifies the type of association for an application. Used by methods of the IApplicationAssociationRegistration interface. /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/ne-shobjidl_core-associationtype [PInvokeData("shobjidl_core.h")] public enum ASSOCIATIONTYPE { /// Indicates a file name extension, such as .htm or .mp3. AT_FILEEXTENSION, /// Indicates a protocol, such as http or mailto. AT_URLPROTOCOL, /// /// Indicates the owner of the startmenu client for a mail or Internet hyperlink. As of Windows 7, this value is used only for /// the MAPI sendmail client. /// AT_STARTMENUCLIENT, /// Indicates the MIME type, such as audio/mp3. AT_MIMETYPE, } /// /// Values used by the SHGetItemFromDataObject function to specify options concerning the processing of the source object. /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/ne-shobjidl_core-dataobj_get_item_flags typedef enum // DATAOBJ_GET_ITEM_FLAGS { DOGIF_DEFAULT , DOGIF_TRAVERSE_LINK , DOGIF_NO_HDROP , DOGIF_NO_URL , DOGIF_ONLY_IF_ONE } ; [PInvokeData("shobjidl_core.h", MSDNShortId = "7a5ee490-cf30-452a-ade2-22d875ce0358")] [Flags] public enum DATAOBJ_GET_ITEM_FLAGS { /// No special options. DOGIF_DEFAULT = 0x0000, /// If the source object is a link, base the IShellItem on the link's target rather than the link file itself. DOGIF_TRAVERSE_LINK = 0x0001, /// /// If the source data object does not contain data in the CFSTR_SHELLIDLIST format, which identifies the object through an /// IDList, do not revert to the CF_HDROP format, which uses a file path, as an alternative in the transfer. /// DOGIF_NO_HDROP = 0x0002, /// /// If the source data object does not contain data in the CFSTR_SHELLIDLIST format, which identifies the object through an /// IDList, do not revert to the CFSTR_INETURL clipboard format, which uses a URL, as an alternative in the transfer. /// DOGIF_NO_URL = 0x0004, /// If the source object is an array of items, use it only if the array contains just one item. DOGIF_ONLY_IF_ONE = 0x0008, } /// One of the following values that indicate which known category to add to the list [PInvokeData("Shobjidl.h", MSDNShortId = "dd378397")] public enum KNOWNDESTCATEGORY { /// Add the Frequent category. KDC_FREQUENT = 1, /// Add the Recent category. KDC_RECENT = 2 } /// /// Flags that specify the type of path information to retrieve. This parameter can be a combination of the following values. /// [PInvokeData("Shobjidl.h", MSDNShortId = "bb774944")] [Flags] public enum SLGP { /// Retrieves the standard short (8.3 format) file name. SLGP_SHORTPATH = 1, /// Unsupported; do not use. SLGP_UNCPRIORITY = 2, /// /// Retrieves the raw path name. A raw path is something that might not exist and may include environment variables that need to /// be expanded. /// SLGP_RAWPATH = 4, /// /// Windows Vista and later. Retrieves the path, if possible, of the shortcut's target relative to the path set by a previous /// call to IShellLink::SetRelativePath. /// SLGP_RELATIVEPRIORITY = 8 } /// /// Used with the IFolderView::Items, IFolderView::ItemCount, and IShellView::GetItemObject methods to restrict or control the items /// in their collections. /// public enum SVGIO : uint { /// /// Refers to the background of the view. It is used with IID_IContextMenu to get a shortcut menu for the view background and /// with IID_IDispatch to get a dispatch interface that represents the ShellFolderView object for the view. /// SVGIO_BACKGROUND = 0, /// /// Refers to the currently selected items. Used with IID_IDataObject to retrieve a data object that represents the selected items. /// SVGIO_SELECTION = 0x1, /// Used in the same way as SVGIO_SELECTION but refers to all items in the view. SVGIO_ALLVIEW = 0x2, /// /// Used in the same way as SVGIO_SELECTION but refers to checked items in views where checked mode is supported. For more /// details on checked mode, see FOLDERFLAGS. /// SVGIO_CHECKED = 0x3, /// Masks all bits but those corresponding to the _SVGIO flags. SVGIO_TYPE_MASK = 0xf, /// /// Returns the items in the order they appear in the view. If this flag is not set, the selected item will be listed first. /// SVGIO_FLAG_VIEWORDER = 0x80000000, } /// /// /// Exposes methods that query and set default applications for specific file Association Type, and protocols at a specific /// Association Level. /// /// Note As of Windows 8, the only functionality of this interface that is supported is QueryCurrentDefault. /// /// /// /// Because IApplicationAssociationRegistration is only supported for Windows Vista and Windows 7, applications that support /// earlier operating systems must use their preexisting code in relation to defaults when running under those operating systems. /// Those applications should include a check for the operating system version to account for this. /// /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nn-shobjidl_core-iapplicationassociationregistration [PInvokeData("shobjidl_core.h", MSDNShortId = "015a3be4-2e74-4a2b-8c02-54dcbf0ecacd")] [ComImport, Guid("4e530b0a-e611-4c77-a3ac-9031d022281b"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown), CoClass(typeof(ApplicationAssociationRegistration))] public interface IApplicationAssociationRegistration { void QueryCurrentDefault([MarshalAs(UnmanagedType.LPWStr)] string pszQuery, ASSOCIATIONTYPE atQueryType, ASSOCIATIONLEVEL alQueryLevel, [MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef = typeof(CoTaskMemStringMarshaler))] out string ppszAssociation); void QueryAppIsDefault([MarshalAs(UnmanagedType.LPWStr)] string pszQuery, ASSOCIATIONTYPE atQueryType, ASSOCIATIONLEVEL alQueryLevel, [MarshalAs(UnmanagedType.LPWStr)] string pszAppRegistryName, [MarshalAs(UnmanagedType.Bool)] out bool pfDefault); void QueryAppIsDefaultAll(ASSOCIATIONLEVEL alQueryLevel, [MarshalAs(UnmanagedType.LPWStr)] string pszAppRegistryName, [MarshalAs(UnmanagedType.Bool)] out bool pfDefault); void SetAppAsDefault([MarshalAs(UnmanagedType.LPWStr)] string pszAppRegistryName, [MarshalAs(UnmanagedType.LPWStr)] string pszSet, ASSOCIATIONTYPE atSetType); void SetAppAsDefaultAll([MarshalAs(UnmanagedType.LPWStr)] string pszAppRegistryName); void ClearUserAssociations(); } /// /// Exposes methods that allow an application to remove one or all destinations from the Recent or Frequent categories in a Jump List. /// [SuppressUnmanagedCodeSecurity] [ComImport, Guid("12337d35-94c6-48a0-bce7-6a9c69d4d600"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)] [PInvokeData("Shobjidl.h", MSDNShortId = "dd378413")] public interface IApplicationDestinations { /// /// Specifies a unique AppUserModelID for the application from whose taskbar button's Jump List the methods of this interface /// will remove destinations. This method is optional. /// /// /// Pointer to the AppUserModelID of the process whose taskbar button representation receives the Jump List. /// void SetAppID([MarshalAs(UnmanagedType.LPWStr)] string pszAppID); /// Removes a single destination from the Recent and Frequent categories in a Jump List. /// A pointer to the IShellItem or IShellLink that represents the destination to remove. void RemoveDestination([MarshalAs(UnmanagedType.IUnknown)] object punk); /// Clears all destination entries from the Recent and Frequent categories in an application's Jump List. void RemoveAllDestinations(); } /// Allows an application to retrieve the most recent and frequent documents opened in that app, as reported via SHAddToRecentDocs /// Critical: Suppresses unmanaged code security. [SuppressUnmanagedCodeSecurity] [ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("3c594f9f-9f30-47a1-979a-c9e83d3d0a06")] [PInvokeData("Shobjidl.h", MSDNShortId = "bb762502")] public interface IApplicationDocumentLists { /// /// Set the App User Model ID for the application retrieving this list. If an AppID is not provided via this method, the system /// will use a heuristically determined ID. This method must be called before GetList. /// /// App Id. void SetAppID([MarshalAs(UnmanagedType.LPWStr)] string pszAppID); /// /// Retrieve an IEnumObjects or IObjectArray for IShellItems and/or IShellLinks. Items may appear in both the frequent and recent lists. /// /// Which of the known list types to retrieve /// The number of items desired. /// The interface Id that the return value should be queried for. /// A COM object based on the IID passed for the riid parameter. [return: MarshalAs(UnmanagedType.IUnknown)] object GetList(APPDOCLISTTYPE listtype, uint cItemsDesired, in Guid riid); } /// Exposes methods to set default icons associated with an object. [ComImport, Guid("41ded17d-d6b3-4261-997d-88c60e4b1d58"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)] [PInvokeData("Shobjidl.h")] public interface IDefaultExtractIconInit { /// Sets GIL_XXX flags. See GetIconLocation /// Specifies return flags to get icon location. void SetFlags(GetIconLocationFlags uFlags); /// Sets the registry key from which to load the "DefaultIcon" value. /// A handle to the registry key. void SetKey(HKEY hkey); /// Sets the normal icon. /// /// A pointer to a buffer that contains the full icon path, including the file name and extension, as a Unicode string. This /// pointer can be NULL. /// /// A Shell icon ID. void SetNormalIcon([In, MarshalAs(UnmanagedType.LPWStr)] string pszFile, int iIcon); /// Sets the icon that allows containers to specify an "open" look. /// /// A pointer to a buffer that contains the full icon path, including the file name and extension, as a Unicode string. This /// pointer can be NULL. /// /// Shell icon ID. void SetOpenIcon([In, MarshalAs(UnmanagedType.LPWStr)] string pszFile, int iIcon); /// Sets the icon for a shortcut to the object. /// /// A pointer to a buffer that contains the full icon path, including the file name and extension, as a Unicode string. This /// pointer can be NULL. /// /// Shell icon ID. void SetShortcutIcon([In, MarshalAs(UnmanagedType.LPWStr)] string pszFile, int iIcon); /// Sets the default icon. /// /// A pointer to a buffer that contains the full icon path, including the file name and extension, as a Unicode string. This /// pointer can be NULL. /// /// The Shell icon ID. void SetDefaultIcon([In, MarshalAs(UnmanagedType.LPWStr)] string pszFile, int iIcon); } /// Exposes a method that allows enumeration of a collection of handlers associated with particular file name extensions. [ComImport, Guid("973810ae-9599-4b88-9e4d-6ee98c9552da"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)] [PInvokeData("shobjidl_core.h", MSDNShortId = "9e173cb3-bd73-437c-8853-c13c8b6f216f")] public interface IEnumAssocHandlers { /// Retrieves a specified number of elements. /// The number of elements to retrieve. /// /// When this method returns, contains the address of an array of IAssocHandler pointers. Each IAssocHandler represents a single handler. /// /// When this method returns, contains a pointer to the number of elements retrieved. /// If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. [PreserveSig] HRESULT Next(uint celt, out IntPtr rgelt, out uint pceltFetched); } /// /// Exposes a standard set of methods used to enumerate the pointers to item identifier lists (PIDLs) of the items in a Shell folder. /// When a folder's IShellFolder::EnumObjects method is called, it creates an enumeration object and passes a pointer to the object's /// IEnumIDList interface back to the calling application. /// [SuppressUnmanagedCodeSecurity] [ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("000214F2-0000-0000-C000-000000000046")] [PInvokeData("Shobjidl.h", MSDNShortId = "bb761982")] public interface IEnumIDList { /// /// Retrieves the specified number of item identifiers in the enumeration sequence and advances the current position by the /// number of items retrieved. /// /// The number of elements in the array referenced by the rgelt parameter. /// /// The address of a pointer to an array of ITEMIDLIST pointers that receive the item identifiers. The implementation must /// allocate these item identifiers using CoTaskMemAlloc. The calling application is responsible for freeing the item identifiers /// using CoTaskMemFree. /// /// /// A pointer to a value that receives a count of the item identifiers actually returned in rgelt. The count can be smaller than /// the value specified in the celt parameter. This parameter can be NULL on entry only if celt = 1, because in that case the /// method can only retrieve one (S_OK) or zero (S_FALSE) items. /// /// /// Returns S_OK if the method successfully retrieved the requested celt elements. This method only returns S_OK if the full /// count of requested items are successfully retrieved. S_FALSE indicates that more items were requested than remained in the /// enumeration.The value pointed to by the pceltFetched parameter specifies the actual number of items retrieved. Note that the /// value will be 0 if there are no more items to retrieve. /// [PreserveSig] HRESULT Next(uint celt, out IntPtr rgelt, out uint pceltFetched); /// Skips the specified number of elements in the enumeration sequence. /// The number of item identifiers to skip. void Skip(uint celt); /// Returns to the beginning of the enumeration sequence. void Reset(); /// Creates a new item enumeration object with the same contents and state as the current one. /// /// The address of a pointer to the new enumeration object. The calling application must eventually free the new object by /// calling its Release member function. /// [return: MarshalAs(UnmanagedType.Interface)] IEnumIDList Clone(); } /// Exposes methods that store file system information for optimizing calls to IShellFolder::ParseDisplayName. [ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("01E18D10-4D8B-11d2-855D-006008059367")] [PInvokeData("Shobjidl.h", MSDNShortId = "bb775671")] public interface IFileSystemBindData { /// Stores file system information in a WIN32_FIND_DATA structure. This information is used by IShellFolder::ParseDisplayName. /// A pointer to the WIN32_FIND_DATA structure that specifies the data you want to store. void SetFindData(in WIN32_FIND_DATA pfd); /// Gets the file system information stored in the WIN32_FIND_DATA structure. /// A pointer to the WIN32_FIND_DATA structure that receives the data. void GetFindData(out WIN32_FIND_DATA pfd); } /// /// Extends IFileSystemBindData, which stores file system information for optimizing calls to IShellFolder::ParseDisplayName. This /// interface adds the ability set or get file ID or junction class identifier (CLSID). /// /// [ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("3acf075f-71db-4afa-81f0-3fc4fdf2a5b8")] [PInvokeData("Shobjidl.h", MSDNShortId = "bb775660")] public interface IFileSystemBindData2 : IFileSystemBindData { /// Stores file system information in a WIN32_FIND_DATA structure. This information is used by IShellFolder::ParseDisplayName. /// A pointer to the WIN32_FIND_DATA structure that specifies the data you want to store. new void SetFindData(in WIN32_FIND_DATA pfd); /// Gets the file system information stored in the WIN32_FIND_DATA structure. /// A pointer to the WIN32_FIND_DATA structure that receives the data. new void GetFindData(out WIN32_FIND_DATA pfd); /// Sets the unique file identifier for the current file. /// /// A unique file identifier for the current file. liFileID is a value that is a concatenation of the values nFileIndexHigh and /// nFileIndexlow, noted in structure _by_handle_file_information. /// void SetFileID(long liFileID); /// Gets the unique file identifier for the current file. /// /// When this method returns successfully, receives a pointer to the unique file identifier for the current file. pliFileID is a /// pointer to a value that is a concatenation of the values nFileIndexHigh and nFileIndexlow, noted in structure _by_handle_file_information. /// long GetFileID(); /// /// Sets the class identifier (CLSID) of the object that implements IShellFolder, if the current item is a junction point. /// /// The CLSID for the object that implements IShellFolder with a junction point as its current item. void SetJunctionCLSID(in Guid clsid); /// /// Gets the class identifier (CLSID) of the object that implements IShellFolder for the item, if the item is a junction point. /// /// /// When this method returns successfully, receives a pointer to the CLSID of the object that implements IShellFolder for the /// current item, if the item is a junction point. /// [return: MarshalAs(UnmanagedType.LPStruct)] Guid GetJunctionCLSID(); } /// /// Exposes methods that the Shell uses to retrieve flags and info tip information for an item that resides in an IShellFolder /// implementation. Info tips are usually displayed inside a tooltip control. /// [ComImport, Guid("00021500-0000-0000-C000-000000000046"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb761359")] public interface IQueryInfo { /// Gets the information tip. /// /// Flags that direct the handling of the item from which you're retrieving the info tip text. This value is commonly zero (QITIPF_DEFAULT). /// /// /// The address of a Unicode string pointer that, when this method returns successfully, receives the tip string pointer. /// Applications that implement this method must allocate memory for ppwszTip by calling CoTaskMemAlloc. Calling applications /// must call CoTaskMemFree to free the memory when it is no longer needed. /// /// > void GetInfoTip(QITIP dwFlags, [MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef = typeof(CoTaskMemStringMarshaler))] out string ppwszTip); /// Gets the information flags for an item. This method is not currently used. /// /// A pointer to a value that receives the flags for the item. If no flags are to be returned, this value should be set to zero. /// uint GetInfoFlags(); } /// Retrieves the User Model AppID that has been explicitly set for the current process via SetCurrentProcessExplicitAppUserModelID /// The application identifier. /// [DllImport(Lib.Shell32, ExactSpelling = true)] [PInvokeData("Shobjidl.h", MSDNShortId = "dd378419")] public static extern HRESULT GetCurrentProcessExplicitAppUserModelID([MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef = typeof(CoTaskMemStringMarshaler))] out string AppID); /// Clones an ITEMIDLIST structure. /// A pointer to the ITEMIDLIST structure to be cloned. /// Returns a pointer to a copy of the ITEMIDLIST structure pointed to by pidl. [DllImport(Lib.Shell32, ExactSpelling = true, SetLastError = false)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776433")] public static extern PIDL ILClone(IntPtr pidl); /// Clones the first SHITEMID structure in an ITEMIDLIST structure. /// A pointer to the ITEMIDLIST structure to be cloned. /// /// A pointer to an ITEMIDLIST structure that contains the first SHITEMID structure from the ITEMIDLIST structure specified by pidl. /// Returns NULL on failure. /// [DllImport(Lib.Shell32, ExactSpelling = true, SetLastError = false)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776435")] public static extern PIDL ILCloneFirst(IntPtr pidl); /// Combines two ITEMIDLIST structures. /// A pointer to the first ITEMIDLIST structure. /// /// A pointer to the second ITEMIDLIST structure. This structure is appended to the structure pointed to by pidl1. /// /// /// Returns an ITEMIDLIST containing the combined structures. If you set either pidl1 or pidl2 to NULL, the returned ITEMIDLIST /// structure is a clone of the non-NULL parameter. Returns NULL if pidl1 and pidl2 are both set to NULL. /// [DllImport(Lib.Shell32, ExactSpelling = true, SetLastError = false)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776437")] public static extern PIDL ILCombine(IntPtr pidl1, IntPtr pidl2); /// Returns the ITEMIDLIST structure associated with a specified file path. /// /// A pointer to a null-terminated Unicode string that contains the path. This string should be no more than MAX_PATH characters in /// length, including the terminating null character. /// /// Returns a pointer to an ITEMIDLIST structure that corresponds to the path. [DllImport(Lib.Shell32, CharSet = CharSet.Auto, SetLastError = false)] [PInvokeData("Shobjidl.h", MSDNShortId = "dd378420")] public static extern PIDL ILCreateFromPath(string pszPath); /// Returns a pointer to the last SHITEMID structure in an ITEMIDLIST structure. /// A pointer to an ITEMIDLIST structure. /// A pointer to the last SHITEMID structure in pidl. [DllImport(Lib.Shell32, ExactSpelling = true, SetLastError = false)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776440")] public static extern IntPtr ILFindLastID(IntPtr pidl); /// Frees an ITEMIDLIST structure allocated by the Shell. /// A pointer to the ITEMIDLIST structure to be freed. This parameter can be NULL. [DllImport(Lib.Shell32, ExactSpelling = true, SetLastError = false)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776441")] public static extern void ILFree(IntPtr pidl); /// Returns the size, in bytes, of an SHITEMID structure. /// A pointer to an SHITEMID structure. /// The size of the SHITEMID structure specified by pidl, in bytes. [PInvokeData("Shobjidl.h", MSDNShortId = "bb762502")] public static int ILGetItemSize(IntPtr pidl) => pidl.Equals(IntPtr.Zero) ? 0 : Marshal.ReadInt16(pidl); /// Retrieves the next SHITEMID structure in an ITEMIDLIST structure. /// A pointer to a particular SHITEMID structure in a larger ITEMIDLIST structure. /// /// Returns a pointer to the SHITEMID structure that follows the one specified by pidl. Returns NULL if pidl points to the last /// SHITEMID structure. /// [DllImport(Lib.Shell32, ExactSpelling = true, SetLastError = false)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776442")] public static extern IntPtr ILGetNext(IntPtr pidl); /// Returns the size, in bytes, of an ITEMIDLIST structure. /// A pointer to an ITEMIDLIST structure. /// The size of the ITEMIDLIST structure specified by pidl, in bytes. [DllImport(Lib.Shell32, ExactSpelling = true, SetLastError = false)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776443")] public static extern uint ILGetSize(IntPtr pidl); /// Verifies whether a pointer to an item identifier list (PIDL) is a child PIDL, which is a PIDL with exactly one SHITEMID. /// A constant, unaligned, relative PIDL that is being checked. /// Returns TRUE if the given PIDL is a child PIDL; otherwise, FALSE. [PInvokeData("Shobjidl.h", MSDNShortId = "bb776446")] public static bool ILIsChild(IntPtr pidl) => ILIsEmpty(pidl) || ILIsEmpty(ILNext(pidl)); /// Verifies whether an ITEMIDLIST structure is empty. /// A pointer to the ITEMIDLIST structure to be checked. /// TRUE if the pidl parameter is NULL or the ITEMIDLIST structure pointed to by pidl is empty; otherwise FALSE. [PInvokeData("Shobjidl.h", MSDNShortId = "bb776447")] public static bool ILIsEmpty(IntPtr pidl) => ILGetItemSize(pidl) == 0; /// Tests whether two ITEMIDLIST structures are equal in a binary comparison. /// The first ITEMIDLIST structure. /// The second ITEMIDLIST structure. /// Returns TRUE if the two structures are equal, FALSE otherwise. [DllImport(Lib.Shell32, ExactSpelling = true, SetLastError = false)] [return: MarshalAs(UnmanagedType.Bool)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776448")] public static extern bool ILIsEqual(IntPtr pidl1, IntPtr pidl2); /// Tests whether an ITEMIDLIST structure is the parent of another ITEMIDLIST structure. /// A pointer to an ITEMIDLIST (PIDL) structure that specifies the parent. This must be an absolute PIDL. /// A pointer to an ITEMIDLIST (PIDL) structure that specifies the child. This must be an absolute PIDL. /// /// A Boolean value that is set to TRUE to test for immediate parents of pidl2, or FALSE to test for any parents of pidl2. /// /// /// Returns TRUE if pidl1 is a parent of pidl2. If fImmediate is set to TRUE, the function only returns TRUE if pidl1 is the /// immediate parent of pidl2. Otherwise, the function returns FALSE. /// [DllImport(Lib.Shell32, ExactSpelling = true, SetLastError = false)] [return: MarshalAs(UnmanagedType.Bool)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776449")] public static extern bool ILIsParent(IntPtr pidl1, IntPtr pidl2, [MarshalAs(UnmanagedType.Bool)] bool fImmediate); /// Retrieves the next SHITEMID structure in an ITEMIDLIST structure. /// A constant, unaligned, relative PIDL for which the next SHITEMID structure is being retrieved. /// /// When this function returns, contains one of three results: If pidl is valid and not the last SHITEMID in the ITEMIDLIST, then it /// contains a pointer to the next ITEMIDLIST structure. If the last ITEMIDLIST structure is passed, it contains NULL, which signals /// the end of the PIDL. For other values of pidl, the return value is meaningless. /// [PInvokeData("Shobjidl.h", MSDNShortId = "bb776454")] public static IntPtr ILNext(IntPtr pidl) { var size = ILGetItemSize(pidl); return size == 0 ? IntPtr.Zero : pidl.Offset(size); } /// Removes the last SHITEMID structure from an ITEMIDLIST structure. /// /// A pointer to the ITEMIDLIST structure to be shortened. When the function returns, this variable points to the shortened structure. /// /// Returns TRUE if successful, FALSE otherwise. [DllImport(Lib.Shell32, ExactSpelling = true, SetLastError = false)] [return: MarshalAs(UnmanagedType.Bool)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776456")] public static extern bool ILRemoveLastID(IntPtr pidl); /// Returns the ITEMIDLIST structure associated with a specified file path. /// /// A pointer to a null-terminated Unicode string that contains the path. This string should be no more than MAX_PATH characters in /// length, including the terminating null character. /// /// Returns a pointer to an ITEMIDLIST structure that corresponds to the path. [DllImport(Lib.Shell32, EntryPoint = "ILCreateFromPathW", SetLastError = true)] [PInvokeData("Shobjidl.h", MSDNShortId = "dd378420")] public static extern IntPtr IntILCreateFromPath([MarshalAs(UnmanagedType.LPWStr)] string pszPath); /// /// Specifies a unique application-defined Application User Model ID (AppUserModelID) that identifies the current process to the /// taskbar. This identifier allows an application to group its associated processes and windows under a single taskbar button. /// /// Pointer to the AppUserModelID to assign to the current process. [DllImport(Lib.Shell32, ExactSpelling = true)] [PInvokeData("Shobjidl.h", MSDNShortId = "dd378422")] public static extern HRESULT SetCurrentProcessExplicitAppUserModelID([MarshalAs(UnmanagedType.LPWStr)] string AppID); /// /// Returns an enumeration object for a specified set of file name extension handlers. /// /// /// Type: PCWSTR /// /// A pointer to a null-terminated buffer that contains a single file type extension, for instance ".jpg". Only handlers associated /// with the given extension are enumerated. If this value is NULL, all handlers for all extensions are enumerated. /// /// /// /// Type: ASSOC_FILTER /// /// Specifies the enumeration handler filter applied to the full list of handlers that results from the value given in . One of the /// following values. /// /// ASSOC_FILTER_NONE /// Return all handlers. /// ASSOC_FILTER_RECOMMENDED /// /// Return only recommended handlers. A handler sets its recommended status in the registry when it is installed. An initial status /// of non-recommended can later be promoted to recommended as a result of user action. /// /// /// /// Type: IEnumAssocHandlers** /// When this method returns, contains the address of a pointer to an IEnumAssocHandlers object. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shassocenumhandlers SHSTDAPI // SHAssocEnumHandlers( PCWSTR pszExtra, ASSOC_FILTER afFilter, IEnumAssocHandlers **ppEnumHandler ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "83db466b-e00c-4015-879f-c5c222f45b8c")] public static extern HRESULT SHAssocEnumHandlers([MarshalAs(UnmanagedType.LPWStr)] string pszExtra, ASSOC_FILTER afFilter, out IEnumAssocHandlers ppEnumHandler); /// /// Gets an enumeration interface that provides access to handlers associated with a given protocol. /// /// /// Type: PCWSTR /// Pointer to a string that specifies the protocol. /// /// /// Type: REFIID /// A reference to the IID of the interface to retrieve through , typically IID_IEnumAssocHandlers. /// /// /// Type: void** /// When this method returns, contains the interface pointer requested in . This is typically IEnumAssocHandlers. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// /// /// /// It is recommended that you use the IID_PPV_ARGS macro, defined in Objbase.h, to package the and parameters. This macro /// provides the correct IID based on the interface pointed to by the value in , which eliminates the possibility of a coding error. /// /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shassocenumhandlersforprotocolbyapplication // SHSTDAPI SHAssocEnumHandlersForProtocolByApplication( PCWSTR protocol, REFIID riid, void **enumHandlers ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "8bc3b9ce-5909-46a0-b5f1-35ab808aaa55")] public static extern HRESULT SHAssocEnumHandlersForProtocolByApplication([MarshalAs(UnmanagedType.LPWStr)] string protocol, in Guid riid, [MarshalAs(UnmanagedType.IUnknown)] out object enumHandlers); /// /// Creates an IApplicationAssociationRegistration object based on the stock implementation of the interface provided by Windows. /// /// /// Type: REFIID /// A reference to the IID of the requested interface. /// /// /// Type: void** /// When this function returns, contains the address of a pointer to the IApplicationAssociationRegistration object. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shcreateassociationregistration SHSTDAPI // SHCreateAssociationRegistration( REFIID riid, void **ppv ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "7998f49d-2515-4c77-991e-62c0fefa43df")] public static extern HRESULT SHCreateAssociationRegistration(in Guid riid, out IApplicationAssociationRegistration ppv); /// /// Creates a standard icon extractor, whose defaults can be further configured via the IDefaultExtractIconInit interface. /// /// /// Type: REFIID /// A reference to interface ID. /// /// /// Type: void** /// The address of IDefaultExtractIconInit interface pointer. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// /// /// The intended usage for this function is as follows: /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shcreatedefaultextracticon HRESULT // SHCreateDefaultExtractIcon( REFIID riid, void **ppv ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "483dc9ae-4820-47f1-888e-ad7a6bdf3d29")] public static extern HRESULT SHCreateDefaultExtractIcon(in Guid riid, out IDefaultExtractIconInit ppv); /// /// Creates a file operation that sets the default properties on the Shell item that have not already been set. /// /// /// Type: IShellItem* /// A pointer to the source shell item. See IShellItem. /// /// /// Type: IFileOperation** /// The address of the IFileOperation interface pointer. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// /// /// /// The list of properties to set a default value comes from the SetDefaultsFor registry entry under the ProgID for the file /// association of the item. The list is prefixed by and contains the canonical names of the properties to set the default value, for /// example, . The possible properties for this list are System.Author, System.Document.DateCreated, and System.Photo.DateTaken. If /// the SetDefaultsFor entry does not exist on the ProgID, this function uses the default found on the SetDefaultsFor /// entry of HKEY_CLASSES_ROOT<b>*. /// /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl/nf-shobjidl-shcreatedefaultpropertiesop SHSTDAPI // SHCreateDefaultPropertiesOp( IShellItem *psi, IFileOperation **ppFileOp ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl.h", MSDNShortId = "5202ac48-16e7-4d64-8a69-2493036e1e11")] public static extern HRESULT SHCreateDefaultPropertiesOp(IShellItem psi, out IFileOperation ppFileOp); /// /// Creates and initializes a Shell item object from a pointer to an item identifier list (PIDL). The resulting shell item object /// supports the IShellItem interface. /// /// The source PIDL. /// A reference to the IID of the requested interface. /// /// When this function returns, contains the interface pointer requested in riid. This will typically be IShellItem or IShellItem2. /// /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. [DllImport(Lib.Shell32, ExactSpelling = true)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb762133")] public static extern HRESULT SHCreateItemFromIDList(PIDL pidl, in Guid riid, [MarshalAs(UnmanagedType.Interface)] out object ppv); /// Creates and initializes a Shell item object from a parsing name. /// A pointer to a display name. /// /// Optional. A pointer to a bind context used to pass parameters as inputs and outputs to the parsing function. These passed /// parameters are often specific to the data source and are documented by the data source owners. For example, the file system data /// source accepts the name being parsed (as a WIN32_FIND_DATA structure), using the STR_FILE_SYS_BIND_DATA bind context parameter. /// /// STR_PARSE_PREFER_FOLDER_BROWSING can be passed to indicate that URLs are parsed using the file system data source when /// possible.Construct a bind context object using CreateBindCtx and populate the values using IBindCtx::RegisterObjectParam. See /// Bind Context String Keys for a complete list of these.See the Parsing With Parameters Sample for an example of the use of this parameter. /// /// If no data is being passed to or received from the parsing function, this value can be NULL. /// /// A reference to the IID of the interface to retrieve through ppv, typically IID_IShellItem or IID_IShellItem2. /// /// When this method returns successfully, contains the interface pointer requested in riid. This is typically IShellItem or IShellItem2. /// /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. [DllImport(Lib.Shell32, ExactSpelling = true)] [PInvokeData("Shlobjidl.h", MSDNShortId = "bb762134")] public static extern HRESULT SHCreateItemFromParsingName( [In, MarshalAs(UnmanagedType.LPWStr)] string pszPath, [In, Optional] IBindCtx pbc, in Guid riid, [MarshalAs(UnmanagedType.Interface, IidParameterIndex = 2)] out object ppv); /// Creates and initializes a Shell item object from a relative parsing name. /// A pointer to the parent Shell item. /// /// A pointer to a null-terminated, Unicode string that specifies a display name that is relative to the psiParent. /// /// A pointer to a bind context that controls the parsing operation. This parameter can be NULL. /// A reference to an interface ID. /// /// When this function returns, contains the interface pointer requested in riid. This will usually be IShellItem or IShellItem2. /// [DllImport(Lib.Shell32, CharSet = CharSet.Unicode, ExactSpelling = true)] [SecurityCritical, SuppressUnmanagedCodeSecurity] [PInvokeData("Shobjidl.h", MSDNShortId = "bb762135")] public static extern HRESULT SHCreateItemFromRelativeName([In, MarshalAs(UnmanagedType.Interface)] IShellItem psiParent, [In, MarshalAs(UnmanagedType.LPWStr)] string pszName, [In, MarshalAs(UnmanagedType.Interface)] IBindCtx pbc, in Guid riid, [MarshalAs(UnmanagedType.Interface, IidParameterIndex = 3)] out object ppv); /// Creates a Shell item object for a single file that exists inside a known folder. /// A reference to the KNOWNFOLDERID, a GUID that identifies the folder that contains the item. /// /// Flags that specify special options in the object retrieval. This value can be 0; otherwise, one or more of the KNOWN_FOLDER_FLAG values. /// /// /// A pointer to a null-terminated buffer that contains the file name of the new item as a Unicode string. This parameter can also be /// NULL. In this case, an IShellItem that represents the known folder itself is created. /// /// A reference to an interface ID. /// /// When this function returns, contains the interface pointer requested in riid. This will usually be IShellItem or IShellItem2. /// [DllImport(Lib.Shell32, CharSet = CharSet.Unicode, ExactSpelling = true)] [SecurityCritical, SuppressUnmanagedCodeSecurity] [PInvokeData("Shobjidl.h", MSDNShortId = "bb762136")] public static extern HRESULT SHCreateItemInKnownFolder(in Guid kfid, [In] KNOWN_FOLDER_FLAG dwKFFlags, [In, Optional, MarshalAs(UnmanagedType.LPWStr)] string pszItem, in Guid riid, [MarshalAs(UnmanagedType.Interface, IidParameterIndex = 3)] out object ppv); /// Create a Shell item, given a parent folder and a child item ID. /// /// The IDList of the parent folder of the item being created; the IDList of psfParent. This parameter can be NULL, if psfParent is specified. /// /// /// A pointer to IShellFolder interface that specifies the shell data source of the child item specified by the pidl.This parameter /// can be NULL, if pidlParent is specified. /// /// A child item ID relative to its parent folder specified by psfParent or pidlParent. /// A reference to an interface ID. /// /// When this function returns, contains the interface pointer requested in riid. This will usually be IShellItem or IShellItem2. /// [DllImport(Lib.Shell32, CharSet = CharSet.Unicode, ExactSpelling = true)] [SecurityCritical, SuppressUnmanagedCodeSecurity] [PInvokeData("Shobjidl.h", MSDNShortId = "bb762137")] public static extern HRESULT SHCreateItemWithParent([In] PIDL pidlParent, [In, MarshalAs(UnmanagedType.Interface)] IShellFolder psfParent, [In] PIDL pidl, in Guid riid, [MarshalAs(UnmanagedType.Interface, IidParameterIndex = 3)] out object ppvItem); /// Creates a Shell item array object. /// /// The ID list of the parent folder of the items specified in ppidl. If psf is specified, this parameter can be NULL. If this /// pidlParent is not specified, it is computed from the psf parameter using IPersistFolder2. /// /// /// The Shell data source object that is the parent of the child items specified in ppidl. If pidlParent is specified, this parameter /// can be NULL. /// /// The number of elements in the array specified by ppidl. /// The list of child item IDs for which the array is being created. This value can be NULL. /// /// When this function returns, contains the address of an interface pointer. /// [DllImport(Lib.Shell32, CharSet = CharSet.Unicode, ExactSpelling = true)] [SecurityCritical, SuppressUnmanagedCodeSecurity] [PInvokeData("Shobjidl.h", MSDNShortId = "bb762144")] public static extern HRESULT SHCreateShellItemArray([In] PIDL pidlParent, [In, MarshalAs(UnmanagedType.Interface)] IShellFolder psf, uint cidl, [In] PIDL ppidl, out IShellItemArray ppsiItemArray); /// /// Creates a Shell item array object from a data object. /// /// /// Type: IDataObject* /// A pointer to IDataObject interface. /// /// /// Type: REFIID /// A reference to the desired interface ID. /// /// /// Type: void** /// When this method returns, contains the interface pointer requested in . This is typically IShellItemArray. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// /// /// /// This function is useful for Shell extensions that implement IShellExtInit and are passed a data object to the /// IShellExtInit::Initialize method; for example, context menu handlers. /// /// /// This API lets you convert the data object into a Shell item that the handler can consume. It is recommend that handlers use a /// Shell item array rather than clipboard formats like CF_HDROP and CFSTR_SHELLIDLIST (also known as HIDA) as it leads /// to simpler code and allows some performance improvements. /// /// /// The resulting shell item array holds a reference to the source data object. Therefore, that data object must remain valid for the /// lifetime of the shell item array. Notably, the data objects passed to IDropTarget methods are no longer valid after the drop /// operation completes. /// /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shcreateshellitemarrayfromdataobject SHSTDAPI // SHCreateShellItemArrayFromDataObject( IDataObject *pdo, REFIID riid, void **ppv ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "91e65c9a-0600-42e3-97f5-2a5960e1ec89")] public static extern HRESULT SHCreateShellItemArrayFromDataObject(IDataObject pdo, in Guid riid, out IShellItemArray ppv); // [DllImport(Lib.Shell32, CharSet = CharSet.Unicode, ExactSpelling = true)] [SecurityCritical, SuppressUnmanagedCodeSecurity] // [PInvokeData("Shlobj.h", MSDNShortId = "bb762141")] public static extern HRESULT SHCreateShellFolderView(in SFV_CREATE pcsfv, // [MarshalAs(UnmanagedType.Interface)] out object ppvItem); /// Creates a Shell item array object from a list of ITEMIDLIST structures. /// The number of elements in the array. /// A list of cidl constant pointers to ITEMIDLIST structures. /// When this function returns, contains an IShellItemArray interface pointer. [DllImport(Lib.Shell32, CharSet = CharSet.Unicode, ExactSpelling = true)] [SecurityCritical, SuppressUnmanagedCodeSecurity] [PInvokeData("Shobjidl.h", MSDNShortId = "bb762146")] public static extern HRESULT SHCreateShellItemArrayFromIDLists(uint cidl, [In, MarshalAs(UnmanagedType.LPArray, SizeParamIndex = 0)] IntPtr[] rgpidl, out IShellItemArray ppsiItemArray); /// /// Creates an array of one element from a single Shell item. /// /// /// Type: IShellItem* /// Pointer to IShellItem object that represents the item. /// /// /// Type: REFIID /// A reference to the IID of the interface to retrieve through , typically IID_IShellItemArray. /// /// /// Type: void** /// When this method returns, contains the interface pointer requested in . This is typically a pointer to an IShellItemArray. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// /// /// This function creates a one-element array from a single item. To create an array from the contents of a folder, use SHCreateShellItemArray. /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shcreateshellitemarrayfromshellitem SHSTDAPI // SHCreateShellItemArrayFromShellItem( IShellItem *psi, REFIID riid, void **ppv ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "93401708-6f11-474d-8009-24554f316e79")] public static extern HRESULT SHCreateShellItemArrayFromShellItem([In] IShellItem psi, in Guid riid, out IShellItemArray ppv); /// /// Creates an IShellItem or related object based on an item specified by an IDataObject. /// /// /// Type: IDataObject* /// A pointer to the source IDataObject instance. /// /// /// Type: DATAOBJ_GET_ITEM_FLAGS /// /// One or more values from the DATAOBJ_GET_ITEM_FLAGS enumeration to specify options regarding the target object. This value can be 0. /// /// /// /// Type: REFIID /// A reference to the IID of the interface to retrieve through , typically IID_IShellItem. /// /// /// Type: void** /// When this method returns, contains the interface pointer requested in . This is typically IShellItem. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// /// /// /// It is recommended that you use the IID_PPV_ARGS macro, defined in Objbase.h, to package the and parameters. This macro /// provides the correct IID based on the interface pointed to by the value in , which eliminates the possibility of a coding error. /// /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shgetitemfromdataobject HRESULT // SHGetItemFromDataObject( IDataObject *pdtobj, DATAOBJ_GET_ITEM_FLAGS dwFlags, REFIID riid, void **ppv ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "1d7b9ffa-9980-4d68-85e4-7bab667be168")] public static extern HRESULT SHGetItemFromDataObject(IDataObject pdtobj, DATAOBJ_GET_ITEM_FLAGS dwFlags, in Guid riid, [MarshalAs(UnmanagedType.Interface, IidParameterIndex = 2)] out object ppv); /// /// Retrieves an IShellItem for an object. /// /// /// Type: IUnknown* /// A pointer to the IUnknown of the object. /// /// /// Type: REFIID /// Reference to the desired IID. /// /// /// Type: void** /// When this method returns, contains the interface pointer requested in . This is typically IShellItem or a related interface. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// /// /// /// From the standpoint of performance, this method is preferred to SHGetIDListFromObject in those cases where the IDList is already /// bound to a folder. /// /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shgetitemfromobject SHSTDAPI // SHGetItemFromObject( IUnknown *punk, REFIID riid, void **ppv ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "0ef494c0-81c7-4fbd-9c37-78861d8ac63b")] public static extern HRESULT SHGetItemFromObject([MarshalAs(UnmanagedType.IUnknown)] object punk, in Guid riid, [MarshalAs(UnmanagedType.Interface, IidParameterIndex = 1)] out object ppv); /// /// Retrieves an object that supports IPropertyStore or related interfaces from a pointer to an item identifier list (PIDL). /// /// /// Type: PCIDLIST_ABSOLUTE /// A pointer to an item ID list. /// /// /// Type: GETPROPERTYSTOREFLAGS /// One or more values from the GETPROPERTYSTOREFLAGS constants. This parameter can also be NULL. /// /// /// Type: REFIID /// A reference to the desired interface ID. /// /// /// Type: void** /// /// When this function returns, contains the interface pointer requested in . This is typically IPropertyStore or a related interface. /// /// /// /// None /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shgetpropertystorefromidlist SHSTDAPI // SHGetPropertyStoreFromIDList( PCIDLIST_ABSOLUTE pidl, GETPROPERTYSTOREFLAGS flags, REFIID riid, void **ppv ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "2a3c3c80-1bfc-4da0-ba6e-ac9e9a5c3e5b")] public static extern HRESULT SHGetPropertyStoreFromIDList(PIDL pidl, GETPROPERTYSTOREFLAGS flags, in Guid riid, [MarshalAs(UnmanagedType.Interface, IidParameterIndex = 2)] out object ppv); /// Returns a property store for an item, given a path or parsing name. /// A pointer to a null-terminated Unicode string that specifies the item path. /// A pointer to a IBindCtx object, which provides access to a bind context. This value can be NULL. /// One or more values from the GETPROPERTYSTOREFLAGS constants. This parameter can also be NULL. /// A reference to the desired interface ID. /// /// When this function returns, contains the interface pointer requested in riid. This is typically IPropertyStore or a related interface. /// /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. [DllImport(Lib.Shell32, ExactSpelling = true)] [PInvokeData("Shlobjidl.h", MSDNShortId = "bb762197")] public static extern HRESULT SHGetPropertyStoreFromParsingName( [In, MarshalAs(UnmanagedType.LPWStr)] string pszPath, [In] IBindCtx pbc, GETPROPERTYSTOREFLAGS flags, in Guid riid, out IPropertyStore propertyStore); /// /// /// Retrieves the temporary property for the given item. A temporary property is a read/write store that holds properties only for /// the lifetime of the IShellItem object, rather than being persisted back into the item. /// /// /// /// Type: IShellItem* /// A pointer to the item for which the temporary property is to be retrieved. /// /// /// Type: REFPROPERTYKEY /// The property key. /// /// /// Type: PROPVARIANT* /// A pointer to the temporary property for the item. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shgettemporarypropertyforitem SHSTDAPI // SHGetTemporaryPropertyForItem( IShellItem *psi, REFPROPERTYKEY propkey, PROPVARIANT *ppropvar ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "53953a5a-04a2-4749-a03b-8cbd5ac889f1")] public static extern HRESULT SHGetTemporaryPropertyForItem(IShellItem psi, in PROPERTYKEY propkey, PROPVARIANT ppropvar); /// /// Applies the default set of properties on a Shell item. /// /// /// Type: HWND /// A handle to the item's parent window, which receives error notifications. This value can be NULL. /// /// /// Type: IShellItem* /// A pointer to the IShellItem object that represents the item. /// /// /// Type: DWORD /// Flags that customize the operation. See IFileOperation::SetOperationFlags for flag values. /// /// /// Type: IFileOperationProgressSink* /// /// A pointer to an IFileOperationProgressSink object used to follow the progress of the operation. See IFileOperation::Advise for /// details. This value can be NULL. /// /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// /// /// /// The list of properties to set a default value comes from the SetDefaultsFor registry entry under the ProgID for the file /// association of the item. The list is prefixed by "" and contains the canonical names of the properties to set the default value, /// for example, "". The possible properties for this list are System.Author, System.Document.DateCreated, and /// System.Photo.DateTaken. If the SetDefaultsFor entry does not exist on the ProgID, this function uses the default found on /// the SetDefaultsFor entry of HKEY_CLASSES_ROOT<b>*. /// /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl/nf-shobjidl-shsetdefaultproperties SHSTDAPI SHSetDefaultProperties( // HWND hwnd, IShellItem *psi, DWORD dwFileOpFlags, IFileOperationProgressSink *pfops ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl.h", MSDNShortId = "c3ab80a3-c1f3-4223-9fe3-f7fe48c36460")] public static extern HRESULT SHSetDefaultProperties(HWND hwnd, IShellItem psi, FILEOP_FLAGS dwFileOpFlags, IFileOperationProgressSink pfops); /// /// /// Sets a temporary property for the specified item. A temporary property is kept in a read/write store that holds properties only /// for the lifetime of the IShellItem object, instead of writing them back into the item. /// /// /// /// Type: IShellItem* /// A pointer to the item on which the temporary property is to be set. /// /// /// Type: REFPROPERTYKEY /// Reference to the PROPERTYKEY that identifies the temporary property that is being set. /// /// /// Type: REFPROPVARIANT /// Reference to a PROPVARIANT that contains the value of the temporary property. /// /// /// Type: HRESULT /// If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. /// /// /// A temporary value can only be read with SHGetTemporaryPropertyForItem or by passing GPS_TEMPORARY to IShellItem2::GetPropertyStore. /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shsettemporarypropertyforitem SHSTDAPI // SHSetTemporaryPropertyForItem( IShellItem *psi, REFPROPERTYKEY propkey, REFPROPVARIANT propvar ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "779b1b2e-cd4b-404f-9d50-ac87b81640d2")] public static extern HRESULT SHSetTemporaryPropertyForItem(IShellItem psi, in PROPERTYKEY propkey, PROPVARIANT propvar); /// /// Deprecated. Returns a pointer to an ITEMIDLIST structure when passed a path. /// /// /// Type: PCWSTR /// A pointer to a null-terminated string that contains the path to be converted to a PIDL. /// /// /// Type: PIDLIST_ABSOLUTE /// Returns a pointer to an ITEMIDLIST structure if successful, or NULL otherwise. /// /// /// Prior to Windows 7, this function was declared in Shlobj.h. In Windows 7 and later versions, it is declared in Shobjidl.h. /// /// Note This function is available through Windows 7 and Windows Server 2003. It is possible that it will not be present in /// future versions of Windows. /// /// An alternative to this function is as follows: /// /// Call SHGetDesktopFolder to obtain IShellFolder for the desktop folder. /// Get the IShellFolder's bind context (IBindCtx). /// Call IShellFolder::ParseDisplayName with the IBindCtx and the path. /// /// // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-shsimpleidlistfrompath PIDLIST_ABSOLUTE // SHSimpleIDListFromPath( PCWSTR pszPath ); [DllImport(Lib.Shell32, SetLastError = false, ExactSpelling = true)] [PInvokeData("shobjidl_core.h", MSDNShortId = "349974c2-4ab9-4eb2-897d-a5934893ed07")] public static extern PIDL SHSimpleIDListFromPath([MarshalAs(UnmanagedType.LPWStr)] string pszPath); /// Clones an ITEMIDLIST structure. /// A pointer to the ITEMIDLIST structure to be cloned. /// Returns a pointer to a copy of the ITEMIDLIST structure pointed to by pidl. [DllImport(Lib.Shell32, EntryPoint = "ILClone", SetLastError = false)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776433")] internal static extern IntPtr IntILClone(IntPtr pidl); /// Combines two ITEMIDLIST structures. /// A pointer to the first ITEMIDLIST structure. /// /// A pointer to the second ITEMIDLIST structure. This structure is appended to the structure pointed to by pidl1. /// /// /// Returns an ITEMIDLIST containing the combined structures. If you set either pidl1 or pidl2 to NULL, the returned ITEMIDLIST /// structure is a clone of the non-NULL parameter. Returns NULL if pidl1 and pidl2 are both set to NULL. /// [DllImport(Lib.Shell32, EntryPoint = "ILCombine", SetLastError = false)] [PInvokeData("Shobjidl.h", MSDNShortId = "bb776437")] internal static extern IntPtr IntILCombine(IntPtr pidl1, IntPtr pidl2); /// Implements CLSID_ApplicationAssociationRegistration to create IApplicationAssociationRegistration. [PInvokeData("shobjidl_core.h")] [ComImport, Guid("591209c7-767b-42b2-9fba-44ee4615f2c7"), ClassInterface(ClassInterfaceType.None)] public class ApplicationAssociationRegistration { } /// Class interface for IEnumerableObjectCollection. [ComImport, Guid("2d3468c1-36a7-43b6-ac24-d3f02fd9607a"), ClassInterface(ClassInterfaceType.None)] public class CEnumerableObjectCollection { } } }