WsFlushBody-Funktion (webservices.h)
Löscht alle kumulierten Nachrichtentextdaten, die geschrieben wurden.
Wenn die Nachricht WsWriteBody oder XML Writer verwendet, werden die Daten in einem Puffer gesammelt. WsFlushBody führt anschließend die tatsächlichen E/A-Vorgänge aus.
WsFlushBody wird in der Regel verwendet, wenn Kanal-E/A auf WS_STREAMED_OUTPUT_TRANSFER_MODE festgelegt ist, oder wenn ein XML Writer-Satz verwendet wird, um WS_XML_WRITER_STREAM_OUTPUT zu verwenden.
HRESULT WsFlushBody(
[in] WS_MESSAGE *message,
[in] ULONG minSize,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
[in] message
Ein Zeiger auf die WS_MESSAGE-Struktur , die die akkumulierten Nachrichtentextdaten enthält.
[in] minSize
Gibt die Mindestanzahl von Bytes an, die in der Nachricht vorhanden sein müssen, damit die Funktion die Datenleerung ausführen kann.
[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.
Diese Funktion kann einen dieser Werte zurückgeben.
Rückgabecode | Beschreibung |
---|---|
|
Der asynchrone Vorgang steht noch aus. |
|
Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert. |
|
Mindestens ein Argument ist ungültig. |
|
Der Arbeitsspeicher ist nicht mehr vorhanden. |
|
Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind. |
Diese Funktion ist "no-op", wenn WS_STREAMED_OUTPUT_TRANSFER_MODE nicht festgelegt ist oder wenn ein XML Writer mit WS_XML_WRITER_BUFFER_OUTPUT festgelegt ist.
Diese Funktion ist eine Verknüpfung zum Aufrufen von WsFlushWriter für den XML Writer, der zum Schreiben der Nachricht verwendet wird. Das direkte Aufrufen von WsFlushWriter entspricht dem Aufrufen dieser Funktion.
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 |