WsRemoveCustomHeader-Funktion (webservices.h)

Artikel
08/27/2023

Entfernt einen benutzerdefinierten Header aus der Nachricht.

Diese Funktion ist für die Verarbeitung von Headertypen konzipiert, die einmal in der Nachricht angezeigt werden und für den ultimativen Empfänger bestimmt sind. Header, die auf eine andere Rolle als den ultimativen Empfänger abzielen, werden ignoriert.

Syntax

HRESULT WsRemoveCustomHeader(
  [in]           WS_MESSAGE          *message,
  [in]           const WS_XML_STRING *headerName,
  [in]           const WS_XML_STRING *headerNs,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] message

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

Die Nachricht kann sich in einem beliebigen Zustand mit Ausnahme WS_MESSAGE_STATE_EMPTY befinden.

[in] headerName

Ein Zeiger auf das WS_XML_STRING-Objekt , das auf den "lokalen Namen" des zu entfernenden Headerelements verweist.

[in] headerNs

Ein Zeiger auf das WS_XML_STRING-Objekt , das auf den Namespace des zu entfernenden Headerelements verweist.

[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_FORMAT	Es sind mehrere Instanzen des Headertyps in der Nachricht vorhanden.
E_OUTOFMEMORY	Zum Serialisieren des Headers war nicht genügend Arbeitsspeicher verfügbar.
E_INVALIDARG	Einer oder mehrere der Parameter sind falsch.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Wenn in der Nachricht ein Header des angegebenen Typs vorhanden ist, wird er entfernt. Wenn der Header nicht vorhanden ist, führt die Funktion keine Aktion aus und wird erfolgreich abgeschlossen.

Anforderungen


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