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.
Rückgabecode | Beschreibung |
---|---|
|
Der Arbeitsspeicher ist nicht mehr vorhanden. |
|
Mindestens ein Argument ist ungültig. |
|
Die Eingabedaten hatten nicht das erwartete Format oder hatten nicht den erwarteten Wert. |
|
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 |