WsRemoveMappedHeader-Funktion (webservices.h)

  • Artikel

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