WS_FAULT-Struktur (webservices.h)
Ein Fehler ist ein Wert, der im Text einer Nachricht enthalten ist, der einen Verarbeitungsfehler vermittelt. Fehler werden mithilfe der WS_FAULT-Struktur modelliert.
Syntax
typedef struct _WS_FAULT {
WS_FAULT_CODE *code;
WS_FAULT_REASON *reasons;
ULONG reasonCount;
WS_STRING actor;
WS_STRING node;
WS_XML_BUFFER *detail;
} WS_FAULT;
Member
code
Der Kopf der Liste der Fehlercodes, die den Fehlertyp identifiziert.
Die Fehlercodes sind von generisch bis spezifisch sortiert. Es muss mindestens ein Fehlercode vorhanden sein. Der erste Fehlercode muss einem durch SOAP definierten Fehlercode entsprechen. Für WS_ENVELOPE_VERSION_SOAP_1_1 wird nur der spezifischste Fehlercode serialisiert (der erste in der Liste).
Wenn der Namespace-URI des ersten Fehlercodes die leere Zeichenfolge ist, wird der erste Fehlercode wie folgt transformiert, wenn der Fehler serialisiert wird, wie folgt:
- Der entsprechende SOAP-Namespace wird basierend auf der WS_ENVELOPE_VERSION verwendet.
- Wenn bei Verwendung von WS_ENVELOPE_VERSION_SOAP_1_1 der lokale Name "Sender" lautet, wird stattdessen "Client" verwendet.
- Wenn der lokale Name "Receiver" lautet, wenn WS_ENVELOPE_VERSION_SOAP_1_1 verwendet wird, wird stattdessen "Server" verwendet.
reasons
Der Text, der den Fehler beschreibt. Dies ist ein Array, das verschiedene Sprachen ermöglicht.
reasonCount
Die Anzahl der Gründe im Gründearray. Dies wäre mehr als eins, wenn der Text in mehreren Sprachen dargestellt wird. Es muss mindestens einen Fehlergrund geben.
Für WS_ENVELOPE_VERSION_SOAP_1_1 wird nur der erste Grund serialisiert.
actor
Der Name des Prozessors, der den Fehler verursacht hat. Wenn die Zeichenfolge 0 (null) ist, wird angenommen, dass sie der Endpunkt ist.
node
Der Speicherort des Prozessors, der den Fehler verursacht hat. Wenn die Zeichenfolge 0 (null) ist, wird angenommen, dass sie der Endpunkt ist.
Für WS_ENVELOPE_VERSION_SOAP_1_1 wird dieser Wert nicht serialisiert.
detail
Die Fehlerdetails ermöglichen das Einbeziehen von XML-Inhalten zusammen mit dem Fehler. Wenn keine Details vorhanden sind, ist dieses Feld möglicherweise NULL.
Für WS_ENVELOPE_VERSION_SOAP_1_1 sollte dies nur verwendet werden, wenn sich der Fehler nicht auf die Verarbeitung eines Headers der Nachricht bezieht. Fehler im Zusammenhang mit Headern sollten einen benutzerdefinierten Header verwenden, um Informationen über den Fehler weiterzuverspeichern.
Wenn Details für den Fehler vorhanden sind, sollte die WS_XML_BUFFER ein Element enthalten, das dem Detailelement eines SOAP-Fehlers entspricht. Der fehlerspezifische XML-Inhalt ist im detail-Element enthalten. Der lokale Name und der Namespace des Elements werden ignoriert. sie werden durch den entsprechenden Elementnamen gemäß der WS_ENVELOPE_VERSION ersetzt, wenn das Detailelement geschrieben wird.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
Kopfzeile | webservices.h |