WsFlushWriter-Funktion (Webservices.h)

Weist den Autor an, den in WS_XML_WRITER_STREAM_OUTPUT angegebenen Rückruf aufzurufen, wenn ausreichende Daten zwischenpuffert wurden.

Syntax

HRESULT WsFlushWriter(
  [in]           WS_XML_WRITER          *writer,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] writer

Der Autor, um zu spülen.

[in] minSize

Gibt die Mindestanzahl von Bytes an, die gepuffert werden müssen, damit der Rückruf aufgerufen werden soll. Wenn weniger als diese Anzahl von Bytes gepuffert werden, wird der Rückruf nicht aufgerufen. Dies kann verwendet werden, um die Anzahl der i/o-Daten zu minimieren, die beim Schreiben kleiner Datenmengen auftreten.

Null sollte angegeben werden, um sicherzustellen, dass der Rückruf aufgerufen wird.

[in, optional] asyncContext

Informationen zum asynchronen Aufrufen der Funktion oder NULL , wenn sie synchron aufgerufen werden.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens ein Argument ist ungültig.
WS_S_ASYNC	Der asynchrone Vorgang ist noch ausstehend.

Hinweise

Der Autor puffert alle Daten, bis WsFlushWriter aufgerufen wird.

Falls erforderlich, sollte der WsFlushWriter aufgerufen werden, bevor WsFreeWriter aufgerufen wird, um sicherzustellen, dass alle Daten ausgegeben werden.

Durch Angeben eines WS_ASYNC_CONTEXT werden die gepufferten Daten asynchron geschrieben.

Diese Funktion ist ein No-Op, wenn der Autor WS_XML_WRITER_BUFFER_OUTPUT verwendet.

Wenn WsWriteStartElement aufgerufen wurde, das Element jedoch nicht festgelegt wurde (siehe WsWriteStartElement), wird dieses Element nicht gespült.

Wenn diese Funktion beim Verwenden von WS_XML_WRITER_MTOM_ENCODING aufgerufen wird und keine geöffneten Elemente auf dem Writer vorhanden sind, werden die unterstützten MIME-Teile generiert und ausgegeben. Sobald dies geschieht, gibt jede API, die versucht, weiter in das XML-Dokument zu schreiben, WS_E_INVALID_OPERATION zurück. (Siehe Rückgabewerte für Windows-Webdienste.)

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