_KF_DEFINITION_FLAGS enumeration (shobjidl_core.h)
Flags that specify certain known folder behaviors. Used with the KNOWNFOLDER_DEFINITION structure.
Syntax
typedef enum _KF_DEFINITION_FLAGS {
KFDF_LOCAL_REDIRECT_ONLY = 0x2,
KFDF_ROAMABLE = 0x4,
KFDF_PRECREATE = 0x8,
KFDF_STREAM = 0x10,
KFDF_PUBLISHEXPANDEDPATH = 0x20,
KFDF_NO_REDIRECT_UI = 0x40
} ;
Constants
KFDF_LOCAL_REDIRECT_ONLY Value: 0x2 Prevent a per-user known folder from being redirected to a network location. Note that if the known folder has been flagged with KFDF_LOCAL_REDIRECT_ONLY but it is a subfolder of a known folder that is redirected to a network location, this subfolder is redirected also. |
KFDF_ROAMABLE Value: 0x4 Can be roamed through a PC-to-PC synchronization. |
KFDF_PRECREATE Value: 0x8 Create the folder when the user first logs on. Normally a known folder is not created until it is first called. At that time, an API such as SHCreateItemInKnownFolder or IKnownFolder::GetShellItem is called with the KF_FLAG_CREATE flag. However, some known folders need to exist immediately. An example is those known folders under %USERPROFILE%, which must exist to provide a proper view. In those cases, KFDF_PRECREATE is set and Windows Explorer calls the creation API during its user initialization. |
KFDF_STREAM Value: 0x10 Introduced in Windows 7. The known folder is a file rather than a folder. |
KFDF_PUBLISHEXPANDEDPATH Value: 0x20 Introduced in Windows 7. The full path of the known folder, with any environment variables fully expanded, is stored in the registry under HKEY_CURRENT_USER. |
KFDF_NO_REDIRECT_UI Value: 0x40 Introduced in Windows 8.1. Prevent showing the Locations tab in the property dialog of the known folder. |
Remarks
The KF_DEFINITION_FLAGS type is defined in Shobjidl.h as shown here.
typedef DWORD KF_DEFINITION_FLAGS;
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista, Windows 7 [desktop apps only] |
Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
Header | shobjidl_core.h (include Shobjidl.h) |