WS_FAULT-Struktur (webservices.h)

  • Artikel

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:

Mit diesen Transformationen kann ein SOAP-Fehlercode angegeben werden, ohne sich darüber Gedanken machen zu müssen, welche SOAP-Version verwendet wird.

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