WsRemoveMappedHeader-Funktion (webservices.h)

Artikel
08/27/2023

Entfernt alle Instanzen eines zugeordneten Headers aus der Nachricht.

Syntax

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

Parameter

[in] message

Die Nachricht, in der der Header festgelegt werden soll.

Die Nachricht kann sich in einem beliebigen Zustand befinden, aber WS_MESSAGE_STATE_EMPTY.

[in] headerName

Der Name des zugeordneten Headers, der entfernt werden soll.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
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

Eine Nachricht kann zusätzliche transportspezifische Informationen enthalten, die nicht Teil des Nachrichtenumschlags sind. Diese transportspezifischen Informationen können programmgesteuert als Header des Message-Objekts verfügbar gemacht werden. Diese Funktion wird verwendet, um zugeordnete Header aus dem Nachrichtenobjekt zu entfernen. Dies kann von einer benutzerdefinierten Kanalimplementierung verwendet werden, um zugeordnete Header vor dem Senden der Nachricht zu entfernen.

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