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.