Condividi tramite


Funzione WsFillReader (webservices.h)

Assicura che il lettore abbia memorizzato il buffer del conteggio minimo di byte dei dati XML da usare dalle funzioni di lettura successive. Richiama il callback specificato da WS_XML_READER_STREAM_INPUT quante volte necessario per ottenere il numero di byte specificati dal valore del parametro minSize . Al termine, i dati memorizzati nel buffer sono disponibili per altre funzioni di lettura. Se una funzione di lettura successiva richiede più dati rispetto a ciò che è stato ottenuto, la funzione restituirà un'eccezione WS_E_QUOTA_EXCEEDED . Vedere Valori restituiti da Servizi Web Windows.

Sintassi

HRESULT WsFillReader(
  [in]           WS_XML_READER          *reader,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parametri

[in] reader

Puntatore a una struttura WS_XML_READER usata per ottenere i dati.

[in] minSize

Specifica il numero minimo di byte ottenuti dal lettore. Se il conteggio byte corrente è uguale o maggiore del valore di minSize , la funzione non eseguirà alcuna operazione e restituirà immediatamente.

[in, optional] asyncContext

Puntatore a una struttura di dati WS_ASYNC_CONTEXT con informazioni su come richiamare la funzione in modo asincrono. Un valore NULL indica una richiesta per l'operazione sincrona.

[in, optional] error

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

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito Descrizione
WS_S_ASYNC
L'operazione asincrona è ancora in sospeso.

Commenti

Il numero di byte necessari per leggere un particolare segmento di dati XML dipende dalla codifica e dalla relativa formattazione.

Questa funzione è una funzione "no-op" quando viene usata con un lettore usando WS_XML_READER_BUFFER_INPUT.

Specificando un WS_ASYNC_CONTEXT i dati vengono letti in modo asincrono.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione webservices.h
Libreria WebServices.lib
DLL WebServices.dll