WS_READ_CALLBACK funzione di callback (webservices.h)

Articolo
08/27/2023

Usato dal WS_XML_READER per leggere da un'origine in un buffer.

Sintassi

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
)
{...}

Parametri

[in] callbackState

Puntatore void al valore di stato definito dall'utente passato alla funzione che ha accettato questo callback.

bytes

Puntatore void alla posizione in cui devono essere inseriti i dati.

[in] maxSize

Numero massimo di byte che possono essere letti.

[out] actualSize

Puntatore a un valore ULONG che indica il numero di byte effettivamente letti. Può essere minore di maxSize. La restituzione di 0 indica che non sono presenti altri dati.

[in, optional] asyncContext

Puntatore a una struttura WS_ASYNC_CONTEXT contenente informazioni su come richiamare la funzione in modo asincrono. Assegnato NULL se si richiama in modo sincrono.

[in, optional] error

Puntatore a WS_ERROR struttura dei dati in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione di callback non restituisce un valore.

Commenti

La restituzione delle dimensioni 0 nel parametro di output actualSize indica la fine del file.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	webservices.h

Condividi tramite