3.3.5.7 GPO Link Creation and Update
Whenever an administrative tool creates a link from a GPO to a SOM, the "gpLink" attribute on the SOM is updated, which produces an LDAP modifyRequest message from the client to the server (as defined in section 2.2.8.4).
The result of modifyRequest is a modifyResponse message in reply, as defined in [RFC2251] section 4.6. The resultCode field value determines a failure or success for the message. If the value of the modifyResponse message's resultCode is integer 0, it indicates success. Any other resultCode value indicates a failure.
Parameters to the GPO Link Creation event are:
|
Parameter |
Description |
|---|---|
|
SOM DN for the SOM being updated |
The distinguished name (DN) for the object defining the SOM to be updated. |
|
The distinguished name for the GPO to be added to the GPO Link list. |
|
|
GPO Link list |
A list of GPO and GPO Link Options as defined in the "gpLink" attribute on the object referred to by the SOM DN. |
|
GPO Link position |
A GPO Link position is specified that defines the link order for the GPO. |
|
GPO Link Options |
A GPO Link Options is specified. The value for GPO Link Options is defined in the "gpLink" description in section 2.2.2. |
The GPO DN and GPO Link Options specified MUST be inserted in the GPO Link list at the position specified by the GPO Link position parameter or at the end of the GPO Link List if GPO Link position is unspecified. A directory string as defined in the "gpLink" description in section 2.2.2 MUST be created by enumerating the GPO Link list elements in order. The directory string is used as the attribute value in the "SOM Property Update Message", defined in section 2.2.8.4.
The link order for a GPO can be updated by combining a GPO Link Deletion and a GPO Link Creation at the desired GPO Link position.