WsFillReader-Funktion (webservices.h)

Artikel
03/06/2024

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

Freigeben über