Funzione WsReadType (webservices.h)

Articolo
08/27/2023

Leggere un valore di un determinato WS_TYPE da XML in base alla WS_TYPE_MAPPING.

Sintassi

HRESULT WsReadType(
  [in]           WS_XML_READER   *reader,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [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] typeMapping

Viene descritto il mapping del tipo al codice XML letto.

[in] type

Tipo del valore da deserializzare.

[in, optional] typeDescription

Informazioni aggiuntive sul tipo. Ogni tipo ha una struttura di descrizione diversa. Può trattarsi di NULL, a seconda del WS_TYPE.

[in] readOption

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

Questo parametro deve avere uno dei valori seguenti:

[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

Vedere WS_TYPE_MAPPING per informazioni su come usare questa funzione per leggere i valori da elementi e attributi.

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