IKnownFolder interface (shobjidl_core.h)
Exposes methods that allow an application to retrieve information about a known folder's category, type, GUID, pointer to an item identifier list (PIDL) value, redirection capabilities, and definition. It provides a method for the retrieval of a known folder's IShellItem object. It also provides methods to get or set the path of the known folder.
Inheritance
The IKnownFolder interface inherits from the IUnknown interface. IKnownFolder also has these types of members:
Methods
The IKnownFolder interface has these methods.
| IKnownFolder::GetCategory Retrieves the category�virtual, fixed, common, or per-user�of the selected folder. |
| IKnownFolder::GetFolderDefinition Retrieves a structure that contains the defining elements of a known folder, which includes the folder's category, name, path, description, tooltip, icon, and other properties. |
| IKnownFolder::GetFolderType Retrieves the folder type. |
| IKnownFolder::GetId Gets the ID of the selected folder. |
| IKnownFolder::GetIDList Gets the location of the Shell namespace folder in the IDList (ITEMIDLIST) form. |
| IKnownFolder::GetPath Retrieves the path of a known folder as a string. |
| IKnownFolder::GetRedirectionCapabilities Gets a value that states whether the known folder can have its path set to a new value or what specific restrictions or prohibitions are placed on that redirection. |
| IKnownFolder::GetShellItem Retrieves the location of a known folder in the Shell namespace in the form of a Shell item (IShellItem or derived interface). |
| IKnownFolder::SetPath Assigns a new path to a known folder. |
Remarks
IKnownFolder objects can be obtained through several methods of the IKnownFolderManager interface, such as IKnownFolderManager::GetFolder and IKnownFolderManager::FindFolderFromIDList.
Third parties do not implement IKnownFolder. Use the provided implementation.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | shobjidl_core.h (include Shobjidl.h) |