WsReadNode-Funktion (webservices.h)

  • Artikel

Durch diesen Vorgang wird der Reader auf den nächsten Knoten im Eingabedatenstrom verschoben. Wenn bei der Analyse der Eingabe ein Fehler auftritt, gibt die Funktion WS_E_INVALID_FORMAT zurück. (Siehe Rückgabewerte für Windows-Webdienste.)

Syntax

HRESULT WsReadNode(
  [in]           WS_XML_READER *reader,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] reader

Ein Zeiger auf das XML Reader-Objekt , das erweitert werden soll. Der Zeiger muss auf einen gültigen WS_XML_READER verweisen und darf nicht NULL sein.

[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, oder es wurden mehrere Elemente der obersten Ebene gefunden, und WS_XML_READER_PROPERTY_ALLOW_FRAGMENT ist FALSE.
WS_E_QUOTA_EXCEEDED
 Es wurde ein Element gelesen, das einen Bestimmten Grenzwert wie WS_XML_READER_PROPERTY_MAX_DEPTH oder WS_XML_READER_PROPERTY_MAX_ATTRIBUTES überschritten hat.

Hinweise

Weitere Ausnahmebedingungen sind:

  • Wenn eine XML-Deklaration gefunden und WS_XML_READER_PROPERTY_READ_DECLARATIONFALSE ist, wird WS_E_INVALID_FORMAT zurückgegeben.
  • Wenn der Reader WS_XML_READER_STREAM_INPUT verwendet und nicht genügend Daten gepuffert wurden, gibt der Reader WS_E_QUOTA_EXCEEDED zurück.

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