Expand Minimize
This topic has not yet been rated - Rate this topic

KF_DEFINITION_FLAGS enumeration

Flags that specify certain known folder behaviors. Used with the KNOWNFOLDER_DEFINITION structure.

Syntax


typedef enum _KF_DEFINITION_FLAGS { 
  KFDF_LOCAL_REDIRECT_ONLY  = 0x00000002,
  KFDF_ROAMABLE             = 0x00000004,
  KFDF_PRECREATE            = 0x00000008,
  KFDF_STREAM               = 0x00000010,
  KFDF_PUBLISHEXPANDEDPATH  = 0x00000020
} KF_DEFINITION_FLAGS;

Constants

KFDF_LOCAL_REDIRECT_ONLY

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

Can be roamed through a PC-to-PC synchronization.

KFDF_PRECREATE

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

Windows 7 and later. The known folder is a file rather than a folder.

KFDF_PUBLISHEXPANDEDPATH

Windows 7 and later. The full path of the known folder, with any environment variables fully expanded, is stored in the registry under HKEY_CURRENT_USER.

Remarks

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


typedef DWORD KF_DEFINITION_FLAGS;

Requirements

Minimum supported client

Windows Vista, Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

 

 

Send comments about this topic to Microsoft

Build date: 11/28/2012

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.