Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The following operations are defined by the WS-Enumeration [WSENUM] protocol. This protocol specifies extensions to the request, response, and SOAP faults associated with these operations.
|
Operation |
Description |
|---|---|
|
wsen:Enumerate |
Creates a context mapped to the query filter specified for search. |
|
wsen:Pull |
Pulls the resultant objects in the context of a specific enumeration. |
|
wsen:Renew |
Renews the expiration time of the specified enumeration context. |
|
wsen:GetStatus |
Gets the expiration time of the specified enumeration context. |
|
wsen:Release |
Releases the specified enumeration context. |
WS-Enumeration [WSENUM] section 3.6 states that if the server terminates an enumeration unexpectedly, it should send an EnumerationEnd SOAP message to the endpoint reference indicated when the enumeration was created.<6>
The subsequent sections also document the SOAP faults specified for use by servers that implement the [MS-WSDS] protocol extensions for specific operations. These faults SHOULD be used by servers while processing a WS-Enumeration [WSENUM] message to indicate to the client that a server-side error has occurred. Many of the faults are adopted from the WS-Enumeration [WSENUM] protocol, and some are from WS-Addressing [WSAddressing]; WSDS assigns these faults a specific meaning within the context of a WS-Enumeration operation that uses the WSDS extensions.
Server implementations are permitted to return additional faults beyond those described as follows. Where applicable, make use of the documented faults in order to maximize interoperability.
Some of the SOAP faults documented as follows specify English-language text in their fault reason. Server implementations are permitted to localize this text to other languages. Such localizations SHOULD maintain, to the extent possible, the same meaning as the English text supplied in this document.
All SOAP faults defined in this document MUST be sent as described in [WSASB] section 6.
In the tables describing faults in the later sections, the following apply.
[Code] is the SOAP fault code.
[Subcode] is the SOAP fault subcode.
[Action] is the SOAP action URI for the fault.
[Reason] is a human-readable explanation of the error.
[Details] is an illustrative example of the fault detail. If not present, WSDS does not specify a fault detail for the fault.