WsGetHeaderAttributes-Funktion (webservices.h)

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.

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