WS_FAULT_ERROR_PROPERTY_ID enumeration

Information about a fault.

Syntax

enum WS_FAULT_ERROR_PROPERTY_ID {  WS_FAULT_ERROR_PROPERTY_FAULT   = 0, 
  WS_FAULT_ERROR_PROPERTY_ACTION, 
  WS_FAULT_ERROR_PROPERTY_HEADER 

};

Constants

WS_FAULT_ERROR_PROPERTY_FAULT

An optional WS_FAULT value that is the fault representation of the error. If no fault representation is present, then the value is NULL.

To set the WS_FAULT value, pass a WS_FAULT* to WsSetFaultErrorProperty. The error object will make a copy of the WS_FAULT. The error object will also add the fault string of the fault to the set of error strings in the error object if the language of the fault string matches that of the error object.

To get the WS_FAULT value, pass a WS_FAULT** to WsGetFaultErrorProperty, which will either return NULL (indicating no fault has been set), or will return a non-NULL pointer to the WS_FAULT. The non-NULL pointer is valid until WsResetError or WsFreeError are called for the error object.

The default value is NULL.

WS_FAULT_ERROR_PROPERTY_ACTION

An optional WS_XML_STRING value representing the action to use for the fault. If the length of the string is zero, then no action is present.

To get the string value, pass a WS_XML_STRING* to WsGetFaultErrorProperty. The returned string is valid until WsResetError or WsFreeError are called for the error object.

To set the string value, pass a WS_XML_STRING* to WsSetFaultErrorProperty. The error object will make a copy of the string.

The default value is a zero-length string.

WS_FAULT_ERROR_PROPERTY_HEADER

An optional WS_XML_BUFFER value representing a header to add to the fault message relating to the fault. If the pointer to the XML_BUFFER is NULL, then no header is present.

To get the header value, pass a WS_XML_BUFFER** to WsGetFaultErrorProperty. The returned WS_XML_BUFFER is valid until WsResetError or WsFreeError are called for the error object.

To set the header value, pass a WS_XML_BUFFER** to WsSetFaultErrorProperty. The error object will make a copy of the buffer.

The default value is NULL.

Requirements