Condividi tramite


Funzione WsGetHeaderAttributes (webservices.h)

Questa funzione popola un parametro ULONG con il WS_HEADER_ATTRIBUTES dall'elemento di intestazione in cui è posizionato il lettore. La versione envelope del messaggio viene utilizzata per determinare quali attributi restituire.

Sintassi

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

Parametri

[in] message

Puntatore a una struttura WS_MESSAGE contenente il messaggio da eseguire per la query. Questa versione envelope del messaggio viene utilizzata per determinare quali attributi corrispondono. Il messaggio può trovarsi in qualsiasi stato ad eccezione di WS_MESSAGE_STATE_EMPTY.

[in] reader

Puntatore al lettore di cui eseguire la query. Deve essere valido WS_XML_READER oggetto restituito da WsCreateReader e non può essere NULL.

[out] headerAttributes

In caso di esito positivo, il valore a cui fa riferimento questo puntatore è impostato sugli attributi dell'intestazione.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito Descrizione
E_OUTOFMEMORY
Memoria insufficiente.
E_INVALIDARG
Uno o più argomenti non sono validi.
WS_E_INVALID_FORMAT
I dati di input non erano nel formato previsto o non hanno il valore previsto.
Altri errori
Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Si presuppone che il lettore punti a un elemento di intestazione. Usare l'API lettore XML per posizionare il lettore in modo appropriato.

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