WsPushBytes-Funktion (webservices.h)

Artikel
08/27/2023

Richtet einen Rückruf ein, der aufgerufen werden soll, um Bytes innerhalb eines Elements zu schreiben. In einigen Codierungen kann dies effizienter sein, indem eine Kopie der Daten entfernt wird.

Syntax

HRESULT WsPushBytes(
  [in]           WS_XML_WRITER          *writer,
  [in]           WS_PUSH_BYTES_CALLBACK callback,
  [in, optional] void                   *callbackState,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] writer

Ein Zeiger auf das XML Writer-Objekt, in das die Bytes geschrieben werden. Der Zeiger muss auf eine gültige WS_XML_WRITER verweisen, und der Wert, auf den verwiesen wird, ist möglicherweise nicht NULL.

[in] callback

Dieser Parameter ist der Rückruf, der aufgerufen werden soll, um die Daten zu schreiben.

[in, optional] callbackState

Ein Zeiger auf einen benutzerdefinierten Zustand, der an die Rückruffunktion übergeben wird.

[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
E_INVALIDARG	Mindestens ein Argument ist ungültig.
WS_E_INVALID_OPERATION	Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.

Hinweise

Beim Schreiben mit dem WS_XML_WRITER_MTOM_ENCODING bietet WsPushBytes eine Möglichkeit, Bytes direkt in einen eigenen MIME-Teil zu schreiben und eine Kopie zu vermeiden. Allerdings kann der Writer nach eigenem Ermessen den Rückruf sofort aufrufen, sodass der Aufrufer darauf vorbereitet sein sollte.

Wenn die Codierung dieses Verhalten nicht nutzen kann, ruft WsPushBytes den Rückruf sofort auf und funktioniert so, als ob WsWriteBytes aufgerufen wurde.

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