3.4.4.1 Pull

This section specifies extensions to the Pull operation defined by WS-Enumeration [WSENUM].

WS-Enumeration specifies that the Pull operation, which involves pulling directory object fragments requested during Enumeration, is initiated by sending a Pull request message containing the Pull element inside a soapenv:Body element to the directory server.

On successful processing of a Pull request message, the directory server is expected to return a Pull response message containing the resultant object fragments wrapped by a pullResponse element inside a soapenv:Body element.

WSPELD specifies that the ad:controls element defined in section 2.2.3.1, if present, MUST be the child element of the Pull element in the request message and can be specified in any order in the presence of other child elements. However, for the response message, the protocol mandates that the ad:controls element, if present, MUST be the last child element of the PullResponse element.

See the example in section 4.4 for the WS-Enumeration [WSENUM] Pull request and response message with controls extension.