Funzione WsRemoveMappedHeader (webservices.h)

Articolo
08/27/2023

Rimuove tutte le istanze di un'intestazione mappata dal messaggio.

Sintassi

HRESULT WsRemoveMappedHeader(
  [in]           WS_MESSAGE          *message,
  [in]           const WS_XML_STRING *headerName,
  [in, optional] WS_ERROR            *error
);

Parametri

[in] message

Messaggio in cui impostare l'intestazione.

Il messaggio può essere in qualsiasi stato, ma WS_MESSAGE_STATE_EMPTY.

[in] headerName

Nome dell'intestazione mappata da rimuovere.

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più parametri non sono corretti.
Altri errori	Questa funzione può restituire altri errori non elencati sopra.

Commenti

Un messaggio può contenere informazioni aggiuntive specifiche del trasporto che non fanno parte della busta del messaggio. Queste informazioni specifiche del trasporto possono essere esposte a livello di codice come intestazioni dell'oggetto Message. Questa funzione viene usata per rimuovere le intestazioni mappate dall'oggetto message. Questa operazione può essere usata da un'implementazione del canale personalizzata per rimuovere intestazioni mappate prima di inviare il messaggio.

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