How to Extend Known Folders with Custom Folders
Collapse the table of content
Expand the table of content

How to Extend Known Folders with Custom Folders

Independent software vendors (ISVs) can extend the set of known folders on a system by registering known folders of their own. Once registered, those third-party folders are known to the system. They are found by any call to IKnownFolderManager::GetFolderIds. Note that a known folder must be a per-machine folder. You cannot create a per-user known folder.


Step 1:

Define your known folder through a KNOWNFOLDER_DEFINITION structure.

Step 2:

Register the known folder through a call to IKnownFolderManager::RegisterFolder.


If you create a known folder for your application as part of your installation procedure, you must also include IKnownFolderManager::UnregisterFolder as part of your uninstallation code.

Give consideration to why you want your folder to be included in the known folder system before you register it. You should have a valid reason for elevating your folder to that level of system visibility.

Related topics

Known Folders Sample



© 2016 Microsoft