WsReadChars-Funktion (webservices.h)

Artikel
08/27/2023

Liest eine angegebene Anzahl von Textzeichen aus dem Reader.

Syntax

HRESULT WsReadChars(
  [in]           WS_XML_READER *reader,
                 WCHAR         *chars,
  [in]           ULONG         maxCharCount,
  [out]          ULONG         *actualCharCount,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] reader

Ein Zeiger auf den XML-Reader , aus dem die Zeichendaten gelesen werden sollen. Der Zeiger muss auf ein gültiges WS_XML_READER-Objekt verweisen.

chars

Ein Zeiger auf eine Position für die gelesenen Zeichen.

[in] maxCharCount

Die maximale Anzahl von Zeichen, die gelesen werden sollen.

[out] actualCharCount

Ein Zeiger auf einen ULONG-Wert der tatsächlichen Anzahl gelesener Zeichen. Dies kann kleiner als maxCharCount sein, auch wenn mehr Zeichen vorhanden sind. Es gibt keine weiteren Zeichen, wenn dies null zurückgibt.

[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.
WS_E_QUOTA_EXCEEDED	Ein Kontingent wurde überschritten.

Hinweise

Text wird entweder als Start- oder Endelement gelesen. Kommentare werden übersprungen, und CDATA-Inhalte werden identisch mit Elementinhalten behandelt. Zeichenentitäten werden in ihre nicht gescapete Form konvertiert.

Diese Funktion kann aus einem der in WsReadNode aufgeführten Gründe fehlschlagen.

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