WsCheckMustUnderstandHeaders-Funktion (webservices.h)

Überprüft, ob die angegebenen Header vom Empfänger verstanden wurden.

Syntax

HRESULT WsCheckMustUnderstandHeaders(
  [in]           WS_MESSAGE *message,
  [in, optional] WS_ERROR   *error
);

Parameter

[in] message

Zeiger auf die WS_MESSAGE-Struktur , die die zu verstehenden Header enthält.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , in der zusätzliche Fehlerinformationen gespeichert werden, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Da der Satz von Headern erweiterbar ist, muss ermittelt werden, ob eine Nachricht ausreichend verstanden wurde, um verarbeitet zu werden. Daher kann der Absender diese Funktion verwenden, um anzugeben, welche Header verstanden werden müssen, welche Header als optional oder informativ behandelt werden können.

Standardmäßige Adressierungsheader, z. B. die in WS_HEADER_TYPE definierten, werden automatisch als verstanden angenommen, auch wenn sie nie durch aufrufen von WsGetHeader gelesen werden.

Es wird auch angenommen, dass benutzerdefinierte, anwendungsdefinierte Header, die von WsGetCustomHeader gelesen werden, verstanden werden. Beim Aufrufen von WsGetCustomHeader wird der jeweilige Header automatisch als verstanden markiert.

Bei jedem anderen Header, der von der Anwendung verarbeitet wird, muss die Anwendung den Header explizit als durch Aufrufen von WsMarkHeaderAsUnderstood kennzeichnen. Andernfalls gilt der Header als nicht verstanden.

Diese Funktion sollte aufgerufen werden, nachdem alle Header für eine empfangene Nachricht gelesen wurden. Eine Ausnahme beim Aufrufen dieser Funktion ist der Fall eines Vermittlers, der die Nachricht an einen anderen Knoten weiterleitet, ohne seine Identität (Nachrichten-ID) zu ändern, da der endgültige Knoten die Überprüfung durchführen wird.

Die Funktion schlägt fehl, wenn einer der angegebenen Header nicht verstanden wurde. Wenn ein Fehlerobjekt für die Funktion bereitgestellt wird, wird es mit Informationen aufgefüllt, die zum Senden eines Fehlers verwendet werden können (siehe WsCreateFaultFromError).

Die Nachricht muss sich im zustand WS_MESSAGE_STATE_READING befinden.

Anforderungen