Funzione WsCreateReader (webservices.h)

Articolo
08/27/2023

Crea un lettore XML con le proprietà specificate.

Sintassi

HRESULT WsCreateReader(
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 WS_XML_READER                **reader,
  [in, optional] WS_ERROR                     *error
);

Parametri

properties

Matrice di strutture WS_XML_READER_PROPERTY contenenti proprietà facoltative per il lettore XML.

Il valore di questo parametro può essere NULL, nel qual caso il parametro propertyCount deve essere 0 (zero).

Per le proprietà che possono essere usate da Tiy per configurare il lettore XML, vedere l'enumerazione WS_XML_READER_PROPERTY_ID .

[in] propertyCount

Numero di proprietà nella matrice delle proprietà .

reader

In caso di esito positivo, un puntatore che riceve l'indirizzo della struttura WS_XML_READER che rappresenta il nuovo lettore XML.

Quando questa struttura non è più necessaria, è necessario liberarla chiamando WsFreeReader.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Se la funzione ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore HRESULT.

Commenti

Utilizzare le funzioni WsSetInput o WsSetInputToBuffer per scegliere la codifica per il lettore XML e per indicare l'origine dell'input.

Se WS_READ_CALLBACK viene specificato nella struttura WS_XML_READER_INPUT passata alla funzione WsSetInput , il lettore XML legge dati aggiuntivi solo quando viene chiamato WsFillReader . In questo modo il chiamante può determinare la granularità per leggere i dati e se leggere tali dati in modo asincrono.

Una struttura WS_XML_READER può essere riutilizzata chiamando di nuovo WsSetInput o WsSetInputToBuffer .

Se un'operazione API che opera su un WS_XML_READER ha esito negativo, il lettore XML viene lasciato in uno stato di errore e altre chiamate di funzione restituiscono WS_E_OBJECT_FAULTED. Vedere Valori restituiti di Servizi Web Windows. L'unica possibile chiamata di funzione per il lettore XML se si verifica è WsSetInput e WsSetInputToBuffer per restituire il lettore XML a uno stato utilizzabile o WsFreeReader per il rilascio dell'oggetto lettore XML.

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