WsGetHeaderAttributes-Funktion (webservices.h)

  • Artikel

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