WsReadCharsUtf8-Funktion (webservices.h)

Liest eine angegebene Anzahl von Textzeichen aus dem Reader und gibt sie zurück, die in UTF-8 codiert sind.

Syntax

HRESULT WsReadCharsUtf8(
  [in]           WS_XML_READER *reader,
                 BYTE          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [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.

bytes

Ein Zeiger auf den Puffer zum Platzieren der codierten Bytes, die gelesen wurden.

[in] maxByteCount

Die maximale Anzahl von Bytes, die gelesen werden sollen.

[out] actualByteCount

Ein Zeiger auf einen ULONG-Wert der tatsächlichen Anzahl der gelesenen Bytes. Dies kann kleiner als maxByteCount sein, auch wenn mehr Bytes vorhanden sind. Wenn null zurückgegeben wird, sind keine Bytes mehr vorhanden.

[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

XML-Text wird entweder bis zu einem Start- oder Endelement gelesen. Kommentare werden übersprungen, und CDATA-Inhalte werden identisch mit Elementinhalten behandelt. Zeichenentitäten werden in ihre Form ohne Freizeichen konvertiert.

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

Anforderungen