WsFillReader-Funktion (webservices.h)

  • Artikel

Stellt sicher, dass der Reader die minimale Byteanzahl von XML-Daten zur Verwendung durch nachfolgende Leserfunktionen gepuffert hat. Er ruft den von WS_XML_READER_STREAM_INPUT angegebenen Rückruf so oft auf, wie es erforderlich ist, um die Anzahl von Bytes abzurufen, die durch den Wert des minSize-Parameters angegeben wird. Nach Abschluss stehen die gepufferten Daten für andere Leserfunktionen zur Verfügung. Wenn eine nachfolgende Leserfunktion mehr Daten benötigt, als abgerufen wurden, gibt die Funktion eine WS_E_QUOTA_EXCEEDED Ausnahme zurück. (Siehe Rückgabewerte für Windows-Webdienste.)

Syntax

HRESULT WsFillReader(
  [in]           WS_XML_READER          *reader,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] reader

Ein Zeiger auf eine WS_XML_READER Struktur, die zum Abrufen der Daten verwendet wird.

[in] minSize

Gibt die Mindestanzahl von Bytes an, die der Leser abgerufen haben sollte. Wenn die aktuelle gepufferte Byteanzahl gleich oder größer als der Wert von minSize ist, tut die Funktion nichts und gibt sofort zurück.

[in, optional] asyncContext

Ein Zeiger auf eine WS_ASYNC_CONTEXT Datenstruktur mit Informationen zum asynchronen Aufrufen der Funktion. Ein NULL-Wert gibt eine Anforderung für einen synchronen Vorgang an.

[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_S_ASYNC
 Der asynchrone Vorgang steht noch aus.

Hinweise

Die Anzahl von Bytes, die zum Lesen eines bestimmten Segmentes von XML-Daten erforderlich sind, hängt von der Codierung und seiner Formatierung ab.

Diese Funktion ist eine "no-op", wenn sie mit einem Reader mit WS_XML_READER_BUFFER_INPUT verwendet wird.

Durch Angabe eines WS_ASYNC_CONTEXT werden die Daten asynchron gelesen.

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