WsReadChars-Funktion (webservices.h)

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.

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