Funzione WsReadAttribute (webservices.h)

Articolo
03/13/2024

Leggere un attributo che produce un valore del WS_TYPE specificato.

Sintassi

HRESULT WsReadAttribute(
  [in]           WS_XML_READER                  *reader,
  [in]           const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
  [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 sull'elemento contenente l'attributo .

[in] attributeDescription

Puntatore a una descrizione di come deserializzare l'attributo.

[in] readOption

Indica se l'attributo è 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 cercherà l'attributo in base al nome e allo 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