WsReadStartAttribute-Funktion (webservices.h)

  • Artikel

Verschiebt den Reader in das angegebene Attribut, sodass der Inhalt mit WsReadValue, WsReadChars oder WsReadBytes gelesen werden kann.

Wenn der Leser nicht auf einem Startelement positioniert ist, wird eine WS_E_INVALID_FORMAT Ausnahme zurückgegeben.

(Siehe Rückgabewerte für Windows-Webdienste.)

Hinweis Gelesene Attribute werden nicht in einer bestimmten Reihenfolge angezeigt. WsFindAttribute kann verwendet werden, um den Index eines bestimmten Attributs zu suchen.

 

Syntax

HRESULT WsReadStartAttribute(
  [in]           WS_XML_READER *reader,
  [in]           ULONG         attributeIndex,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] reader

Ein Zeiger auf das XML Reader-Objekt , das zum Lesen des Start-Attributs verwendet wird.

[in] attributeIndex

Der Index des zu lesenden Attributs.

[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
WS_E_INVALID_FORMAT
 Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.

Hinweise

Die WsReadNode-Funktion gibt EOF zurück, wenn sie innerhalb eines Attributs erweitert ist. Die WsReadEndAttribute-Funktion kann verwendet werden, um den Reader an das enthaltende Element zurückzugeben.

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