WsReadNode-Funktion (webservices.h)

Artikel
03/06/2024

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

Freigeben über