3.2.1 Abstract Data Model

This section describes a conceptual model of possible data organization that an implementation maintains to participate in this protocol. The described organization is provided to explain how the protocol behaves. This document does not mandate that implementations adhere to this model as long as their external behavior is consistent with what is described in this document.

This Folder Redirection Client-Side Plug-in uses a collection of settings specified in section 2.2.1.1, and stored as a Unicode configuration file at a specific remote storage location, such as a network share. This location is passed to the plug-in by the Group Policy Object, as specified in [MS-GPOL].

The Folder Redirection Client-Side Plug-in parses and interprets the file as specified in section 2 and then configures the folder redirection subsystem with the relevant parameters extracted from the file. The folder redirection subsystem can store its configuration persistently. From the configuration, the Client-Side Plug-in MUST persist the setting that determines the behavior when the folder redirection is removed for the folder.<11> At some later time, 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 (for Version Zero of the protocol) or had Redirect To Local set (for Version One), 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 (typically a directory on the local computer file system).

Note This conceptual data can be implemented using a variety of techniques. An implementation is at liberty to implement such data in any way it pleases.

AlwaysWaitForNetworkAtStartupAndLogon: A Boolean value indicating whether a computer waits for network connectivity at the time of the startup and logon process.<12>

Redirection Destination: For each GPO contained in the New or Changed GPO list and for each security descriptor SID, the UNC path identifying the destination path.

Parent Folder ID: For each GPO contained in the New or Changed GPO list and for each security descriptor SID, the GUID for the well-known user profile folder (see section 1.9) that is the parent folder for the user profile folder being redirected.

Excluded Folders List: For each GPO contained in the New or Changed GPO list and for each security descriptor SID, the list of folders, in the form of binary GUIDs, whose subfolders are excluded from the redirection options being applied.