2.2.4.1 WSManFaultType
A SOAP fault is used to carry error information within a SOAP message. Faults are returned when the SOAP message is successfully delivered by the transport and processed by the services but the message cannot be processed properly.
The WS-Management Protocol defines an extensibility model that allows a service to include additional fault information in the s:Detail element. Web Services Management Protocol Extensions for Windows Server 2003 define WSManFaultType for reporting additional fault information. The schema for WSManFaultType MUST be as follows.
-
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:wsmanfault="http://schemas.microsoft.com/ws/ 2005/06/wsmanfault" targetNamespace="http://schemas.microsoft.com/ws/2005/ 06/wsmanfault" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:complexType name="WSManFaultType"> <xs:sequence> <xs:element name="Message" type="wsmanfault:MessageType" minOccurs="0"/> </xs:sequence> <xs:attribute name="Code" type="xs:unsignedInt" use="required"/> <xs:attribute name="Machine" type="xs:string" use="required"/> <xs:anyAttribute processContents="lax"/> </xs:complexType> <xs:complexType name="ProviderFaultType" mixed="true"> <xs:sequence> <xs:any processContents="lax" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:anyAttribute processContents="lax"/> </xs:complexType> <xs:complexType name="MessageType" mixed="true"> <xs:sequence> <xs:element name="ProviderFault" type="wsmanfault:ProviderFaultType" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:schema>
Code: An integer that MUST specify the Windows error code value.
Machine: A string that MUST specify the machine name where this fault occurred.
Message: A complex type that allows mixed content. It can contain a sequence of elements of type ProviderFault and text that contains a user-friendly description of the fault. Each ProviderFault element contains resource-specific fault information. ProviderFault can contain a sequence of elements of xs:any type.
-
Web Services Management Protocol Extensions for Windows Server 2003 servers MUST include either a Message element of xs:string type that contains a user-friendly description of the error or a ProviderFault element that MUST contain WSManFault element of type WSManFaultType. This WSManFault element MUST contain a Message element of xs:string type that contains a user-friendly description of the error.
WSManFault: A complex type that contains a sequence of messages, code, and the machine information.
ProviderFault: An element that MUST contain specific resource provider fault information.