WsReadCharsUtf8-Funktion (webservices.h)

Artikel
08/27/2023

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

Freigeben über