Funzione WsGetHeaderAttributes (webservices.h)

Articolo
08/27/2023

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

Condividi tramite