Funzione WsFillReader (webservices.h)

Articolo
03/09/2024

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

Condividi tramite