3.1.5.3 Policy Administration Load Message Sequencing

  • Article

To load the policy settings in a GPO using administrative tool plug-ins, the state of that GPO on the Group Policy server MUST be read with the following message sequence:

  1. SMB file open from client to server:

    The file name used MUST be a path, as defined in section 2.2.1, and be specific to each preference type, where <gpo path> is the user-scoped GPO path if the GPO's user settings are being loaded or  the computer-scoped GPO path if the computer settings are being loaded.

    The SMB file open MUST request read permission and request that the file not be created if it does not exist.

    If the open request returns a failure status, the Group Policy: Preferences Extension sequence MUST capture the error and allow the administrative plug-in to proceed.

  2. SMB file read sequences:

    If a file was opened, the administrative plug-in MUST perform a series of SMB file reads to load the contents of the opened file. These reads MUST continue until the entire file is copied or an error is encountered.

    If an error is encountered, the protocol sequence MUST be terminated.

  3. File close:

    The administrative tool plug-ins MUST then issue an SMB file close operation if a file was opened.