2.2.2.2.1 Flags Key

The section MUST contain exactly one key with the constant string Flags. The value MUST be a string representation of a hexadecimal value representing the binary OR of a collection of flags. The client-side plug-in passes the flags to the underlying operating system folder redirection subsystem. As specified in the following table, some flags determine what other flags are set in the value and what keys are present in the section. Otherwise, the flags do not affect the behavior of the protocol itself. Those values marked "(same as section 2.2.1.1)" have semantics identical to those of the corresponding flags in section 2.2.1.1; all other flag values either deviate from the section 2.2.1.1 flags or introduce new behaviors relative to section 2.2.1.1.

 Flag value

 Behavior

0x00000001

Move Contents (same as section 2.2.1.1)

Indicates that all contents of the specified folder MUST be moved to the redirected path location.<7>

0x00000002

Follow Parent Folder

This flag indicates that the user profile folder MUST be handled (for purposes of redirection) as ordinary contents of its parent folder. Unlike Version Zero, where the parent folder was specified by convention, in Version One, the parent folder MUST be explicitly specified by the ParentFolder key (see section 2.2.2.2.3).

Exactly one of the following flags: Follow ParentFolder, Redirect to FullPath, or Redirect To Local MUST be set.

The key's parent folder and relative path MUST be present in this section if, and only if, this flag is set.

0x00000004

Redirection Not Specified (same as section 2.2.1.1)

This flag indicates that the administrator has specified no specific redirection path for the folder, and that the folder redirection subsystem MUST continue using whatever redirection configuration it was last configured with.<8>

If this flag is set, all other flags MUST NOT be set, and the Per-Profile section (see section 2.2.1.2) for the corresponding user profile folder MUST NOT appear in the file.

0x00000008

Advanced Redirection (same as section 2.2.1.1)

This flag MUST be used only for display purposes in the administrative-side plug-in. It does not affect the folder redirection protocol, and the client-side plug-in MUST ignore its value.

0x00000010

Exclusive Access

This flag SHOULD<9> indicate that the client folder redirection subsystem MUST create and set the file system access control list on the destination folder to ensure that only the user has access to the contents of the destination folder. This flag is enabled by default.

If the destination folder already exists, and the security descriptor on the folder is protected, the folder redirection subsystem will not set the file system access control list on the destination folder, even if this flag is set

0x00000020

Relocate On Move (same as section 2.2.1.1)

This flag indicates that if the policy is ever deleted in the future, the folder redirection MUST be undone.

he folder redirection subsystem remembers the setting of this flag as well as the security group associated with the Per-Profile mapping that establishes the folder redirection. If the folder redirection subsystem learns via Group Policy that the user no longer belongs to the security group that established the previous redirection, and the previous redirection configuration had the Relocate On Move flag set, then the folder redirection subsystem moves the contents of the user profile folder from the previously configured destination to the default destination for the user profile folder. This destination is typically a directory on the local computer file system

0x00000200

Check Ownership

This flag indicates that the folder redirection subsystem MUST verify (before initiating redirection) that the file system permissions on the destination folder indicate that the user owns the destination folder. If the check fails, the folder redirection subsystem MUST behave as if no redirection had been specified for this user profile folder. Check Ownership is enabled by default.

0x00000800

Do Not InheritFlags

This flag indicates any redirection flags specified for the parent folder MUST NOT be inherited by this folder.

If the Follow Parent Folder flag is set and this flag (Do Not InheritFlags) is not set, all other flags MUST NOT be set. In this case, the plug-in MUST configure the folder redirection subsystem to use the redirection options associated with the user profile folder of which the present user profile is a descendent.

If this flag is set, the Follow Parent Folder flag MUST be set. In this case, the plug-in MUST configure the folder redirection subsystem to use the redirection options specified by this flag's key.

0x00001000

Redirect To FullPath

This flag indicates that the folder MUST be redirected to the full path, as specified in section 2.2.2.2.2.

Exactly one of the following flags: Follow ParentFolder, Redirect To FullPath, or Redirect To Local MUST be set.

The key FullPath MUST be present in this section if, and only if, this flag is set.

0x00002000

Redirect To Local

This flag indicates that the plug-in MUST configure the folder redirection subsystem to use the default destination for the user profile folder, typically a directory on the local computer file system.

Exactly one of the following flags: Follow ParentFolder, Redirect to FullPath, or Redirect To Local MUST be set.

0x00004000

Exclude Known SubFolders

If set, this flag indicates that the specified redirection options MUST NOT be applied to any subfolder associated with a user profile folder identified by a GUID in the value list using the ExcludeFolders key, as specified in section 2.2.2.2.5.

This section MUST contain an ExcludeFolders key if, and only if, this flag is set.

0x00008000

Apply to Downlevel

This flag is used only for display purposes in the administrative-side plug-in. It does not affect the folder redirection protocol, and the client-side plug-in MUST ignore its value.