WsReadChars-Funktion (webservices.h)

  • Artikel

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