Funzione WsReadElement (webservices.h)

Articolo
03/03/2024

Leggere un elemento che produce un valore del WS_TYPE specificato.

Sintassi

HRESULT WsReadElement(
  [in]           WS_XML_READER                *reader,
  [in]           const WS_ELEMENT_DESCRIPTION *elementDescription,
  [in]           WS_READ_OPTION               readOption,
  [in, optional] WS_HEAP                      *heap,
                 void                         *value,
  [in]           ULONG                        valueSize,
  [in, optional] WS_ERROR                     *error
);

Parametri

[in] reader

Lettore posizionato nel codice XML da deserializzare.

[in] elementDescription

Puntatore a una descrizione di come deserializzare l'elemento.

[in] readOption

Indica se l'elemento è obbligatorio e come allocare il valore.
Per altre informazioni, vedere WS_READ_OPTION .

[in, optional] heap

Heap in cui archiviare i valori deserializzati.

value

L'interpretazione di questo parametro dipende dalla WS_READ_OPTION.

[in] valueSize

L'interpretazione di questo parametro dipende dalla WS_READ_OPTION.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
WS_E_INVALID_FORMAT	I dati di input non erano nel formato previsto o non hanno il valore previsto.
E_OUTOFMEMORY	Memoria insufficiente.
WS_E_QUOTA_EXCEEDED	È stata superata la quota di dimensioni dell'heap.
E_INVALIDARG	Uno o più argomenti non sono validi.

Commenti

Questa API passerà all'elemento successivo, verificherà il nome e lo spazio dei nomi e quindi deserializzerà il contenuto come valore tipizzato.

Se l'API non riesce, lo stato del lettore di input diventa indefinito. Le uniche API che possono essere usate nel lettore se si verifica sono WsSetInput e WsSetInputToBuffer per restituire il lettore a uno stato utilizzabile o WsFreeReader per liberare il lettore.

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