IKnownFolder interface

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 retrival of a known folder's IShellItem object. It also provides methods to get or set the path of the known folder.


The IKnownFolder interface has these methods.

Method Description
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.


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.


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)

See Also

Known Folders Sample