KF_CATEGORY Enumeration

Value that represent a category by which a folder registered with the Known Folder system can be classified.

Syntax

typedef enum KF_CATEGORY {
  KF_CATEGORY_VIRTUAL  ,
  KF_CATEGORY_FIXED    ,
  KF_CATEGORY_COMMON   ,
  KF_CATEGORY_PERUSER
} ;

Constants

KF_CATEGORY_VIRTUAL Virtual folders are not part of the file system, which is to say that they have no path. For example, Control Panel and Printers are virtual folders. A number of features such as folder path and redirection do not apply to this category.
KF_CATEGORY_FIXED Fixed file system folders are not managed by the Shell and are usually given a permanent path when the system is installed. For example, the Windows and Program Files folders are fixed folders. A number of features such as redirection do not apply to this category.
KF_CATEGORY_COMMON Common folders are those file system folders used for sharing data and settings, accessible by all users of a system. For example, all users share a common Documents folder as well as their per-user Documents folder.
KF_CATEGORY_PERUSER Per-user folders are those stored under each user's profile and accessible only by that user. For example, %USERPROFILE%\Pictures. This category of folder usually supports many features including aliasing, redirection and customization.
Note  The user profile root folder (FOLDERID_Profile) does not support redirection.
 

Remarks

The KF_CATEGORY type is defined in Shobjidl.h as shown here.

typedef DWORD KF_CATEGORY;

Requirements

   
Windows version Windows Vista [desktop apps only] Windows Server 2008 [desktop apps only]
Header shobjidl_core.h (include Shobjidl.h)

See Also

IKnownFolder::GetCategory

KNOWNFOLDER_DEFINITION

Known Folders Sample