Funzione WsRemoveHeader (webservices.h)

Articolo
03/13/2024

Rimuove l'oggetto WS_HEADER_TYPE standard da un messaggio.

La funzione è progettata per gestire i tipi di intestazioni che vengono visualizzate una volta nel messaggio e sono destinate al ricevitore finale. Le intestazioni destinate a un ruolo diverso dal ricevitore finale vengono ignorate.

Per i tipi di intestazione definiti dall'applicazione, usare la funzione WsRemoveCustomHeader .

Sintassi

HRESULT WsRemoveHeader(
  [in]           WS_MESSAGE     *message,
  [in]           WS_HEADER_TYPE headerType,
  [in, optional] WS_ERROR       *error
);

Parametri

[in] message

Puntatore all'oggetto Message con l'intestazione da rimuovere. Il messaggio può essere in qualsiasi stato tranne WS_MESSAGE_STATE_EMPTY.

[in] headerType

Indica il tipo di intestazione da rimuovere.

[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
WS_E_INVALID_FORMAT	Nel messaggio sono presenti più istanze del tipo di intestazione.
E_INVALIDARG	Uno o più parametri non sono corretti.
Altri errori	Questa funzione può restituire altri errori non elencati sopra.

Commenti

Se esiste un'intestazione del tipo specificato nel messaggio rimosso. Se l'intestazione non esiste, non viene eseguita alcuna azione e la funzione viene completata correttamente.

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