WS_READ_CALLBACK Rückruffunktion (webservices.h)

Artikel
2023-08-27

Wird vom WS_XML_READER verwendet, um aus einer Quelle in einen Puffer zu lesen.

Syntax

WS_READ_CALLBACK WsReadCallback;

HRESULT WsReadCallback(
  [in]           void *callbackState,
                 void *bytes,
  [in]           ULONG maxSize,
  [out]          ULONG *actualSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR *error
)
{...}

Parameter

[in] callbackState

Ein void-Zeiger auf den benutzerdefinierten Zustandswert, der an die Funktion übergeben wurde, die diesen Rückruf akzeptiert hat.

bytes

Ein void-Zeiger auf den Speicherort, an dem die Daten platziert werden sollen.

[in] maxSize

Die maximale Anzahl von Bytes, die gelesen werden können.

[out] actualSize

Ein Zeiger auf einen ULONG-Wert , der die Anzahl der tatsächlich gelesenen Bytes angibt. Dies kann kleiner als maxSize sein. Die Rückgabe von 0 gibt an, dass keine daten mehr vorhanden sind.

[in, optional] asyncContext

Ein Zeiger auf eine WS_ASYNC_CONTEXT-Struktur , die Informationen zum asynchronen Aufrufen der Funktion enthält. Beim synchronen Aufrufen wird NULL zugewiesen.

[in, optional] error

Ein Zeiger auf WS_ERROR Datenstruktur, in der zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Rückruffunktion gibt keinen Wert zurück.

Hinweise

Die Rückgabegröße von 0 im ausgabeparameter actualSize gibt das Ende der Datei an.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h

Freigeben über