WsMarkHeaderAsUnderstood-Funktion (webservices.h)

Artikel
08/27/2023

Diese Funktion markiert einen Header als von der Anwendung "verstanden".

Der Satz von Headern ist erweiterbar, und die Nachrichtenassimilation für den Empfänger ist für den Absender nicht zugänglich. Diese Funktion ist die empfangende Anwendungsmethode, um dem Absender bekannt zu machen, dass der empfangene Header gelesen und verstanden wurde.

Hinweis Diese Funktion sollte nur verwendet werden, wenn die Anwendung eine Meldung empfängt, die angibt, dass der Header verstanden werden muss und der Header nicht mithilfe von WsGetHeader oder WsGetCustomHeader abgerufen wurde.

Die WS_MESSAGE_STATE muss auf WS_MESSAGE_STATE_READING festgelegt sein. Siehe. WsCheckMustUnderstandHeaders für weitere Informationen.

Syntax

HRESULT WsMarkHeaderAsUnderstood(
  [in]           WS_MESSAGE                 *message,
  [in]           const WS_XML_NODE_POSITION *headerPosition,
  [in, optional] WS_ERROR                   *error
);

Parameter

[in] message

Ein Zeiger auf das Message-Objekt mit dem zu markierenden Header.

[in] headerPosition

Ein Zeiger auf die Position des Headerelements im XML-Headersegment.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
WS_E_INVALID_OPERATION	Die Nachricht befindet sich nicht im richtigen Zustand.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
E_OUTOFMEMORY	Der Arbeitsspeicher ist nicht mehr vorhanden.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Wenn die Anwendung den Header mit einem XML-Reader liest, sollte sie eine WS_XML_NODE_POSITION des Headerelements abrufen und an diese Funktion übergeben. Informationen zum Abrufen einer WS_XML_NODE_POSITION finden Sie unter WsGetReaderPosition.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h
Bibliothek	WebServices.lib
DLL	WebServices.dll

Freigeben über