Funzione WsReadAttribute (webservices.h)

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.

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