WsRemoveMappedHeader, fonction (webservices.h)

Supprime du message toutes les instances d’un en-tête mappé.

Syntaxe

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

Paramètres

[in] message

Message dans lequel définir l’en-tête.

Le message peut être dans n’importe quel état , mais WS_MESSAGE_STATE_EMPTY.

[in] headerName

Nom de l’en-tête mappé à supprimer.

[in, optional] error

Spécifie l’emplacement où des informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

Un message peut contenir des informations supplémentaires spécifiques au transport qui ne font pas partie de l’enveloppe du message. Ces informations spécifiques au transport peuvent être exposées par programmation en tant qu’en-têtes de l’objet Message. Cette fonction est utilisée pour supprimer les en-têtes mappés de l’objet message. Cela peut être utilisé par une implémentation de canal personnalisé pour supprimer les en-têtes mappés avant d’envoyer le message.

Configuration requise