WsReadBytes-Funktion (webservices.h)

  • Artikel

Liest Text aus dem Reader und decodiert die Zeichen als Bytes gemäß der Base64-Spezifikation.

Syntax

HRESULT WsReadBytes(
  [in]           WS_XML_READER *reader,
                 void          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] reader

Ein Zeiger auf den XML-Reader , aus dem die Bytes gelesen werden sollen. Der Zeiger muss auf ein gültiges WS_XML_READER-Objekt verweisen.

bytes

Ein Zeiger auf eine Position, an der die decodierten Bytes platziert werden.

[in] maxByteCount

Die maximale Anzahl von Bytes, die gelesen werden sollen.

[out] actualByteCount

Ein Zeiger auf einen ULONG-Wert der tatsächlichen Anzahl gelesener Bytes. Dies kann kleiner als maxByteCount sein, auch wenn mehr Bytes übrig sind.

[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.

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

Anforderungen

   
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