WsGetHeaderAttributes-Funktion (webservices.h)

Artikel
03/03/2024

Diese Funktion füllt einen ULONG-Parameter mit dem WS_HEADER_ATTRIBUTES des Headerelements auf, auf dem sich der Reader befindet. Die Umschlagversion der Nachricht wird verwendet, um zu bestimmen, welche Attribute zurückgegeben werden sollen.

Syntax

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] message

Ein Zeiger auf eine WS_MESSAGE-Struktur , die die abzufragende Nachricht enthält. Diese Umschlagversion der Nachricht wird verwendet, um zu bestimmen, welche Attribute übereinstimmen. Die Nachricht kann sich in einem beliebigen Zustand mit Ausnahme WS_MESSAGE_STATE_EMPTY befinden.

[in] reader

Ein Zeiger auf den abzufragenden Reader. Dies muss WS_XML_READER von WsCreateReader zurückgegebenen Objekt gültig sein und darf nicht NULL sein.

[out] headerAttributes

Bei Erfolg wird der Wert, auf den dieser Zeiger verweist, auf die Headerattribute festgelegt.

[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
E_OUTOFMEMORY	Der Arbeitsspeicher ist nicht mehr vorhanden.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
WS_E_INVALID_FORMAT	Die Eingabedaten hatten nicht das erwartete Format oder hatten nicht den erwarteten Wert.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Es wird davon ausgegangen, dass der Reader auf ein Headerelement zeigt. Verwenden Sie die XML-Reader-API, um den Reader entsprechend zu positionieren.

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