WsReadCharsUtf8-Funktion (webservices.h)

  • Artikel

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.

Rückgabecode Beschreibung
WS_E_INVALID_FORMAT
 Die Eingabedaten hatten nicht das erwartete Format oder hatten nicht den erwarteten Wert.
WS_E_QUOTA_EXCEEDED
 Ein Kontingent wurde überschritten.

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

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