WsRemoveHeader, fonction (webservices.h)
Supprime l’objet WS_HEADER_TYPE standard d’un message.
La fonction est conçue pour gérer les types d’en-têtes qui apparaissent une fois dans le message et qui sont ciblés sur le récepteur final. Les en-têtes ciblés avec un rôle autre que le récepteur final sont ignorés.
Pour les types d’en-têtes définis par l’application, utilisez la fonction WsRemoveCustomHeader .
Syntaxe
HRESULT WsRemoveHeader(
[in] WS_MESSAGE *message,
[in] WS_HEADER_TYPE headerType,
[in, optional] WS_ERROR *error
);
Paramètres
[in] message
Pointeur vers l’objet Message avec l’en-tête à supprimer. Le message peut être dans n’importe quel état, à l’exception de WS_MESSAGE_STATE_EMPTY.
[in] headerType
Indique le type d’en-tête à supprimer.
[in, optional] error
Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur doivent être stockées en cas d’échec de la fonction.
Valeur retournée
Cette fonction peut retourner l’une de ces valeurs.
Code de retour | Description |
---|---|
|
Plusieurs instances du type d’en-tête sont présentes dans le message. |
|
Un ou plusieurs paramètres sont incorrects. |
|
Cette fonction peut retourner d’autres erreurs non répertoriées ci-dessus. |
Remarques
Si un en-tête du type donné existe dans le message, il est supprimé. Si l’en-tête n’existe pas, aucune action n’est effectuée et la fonction se termine correctement.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 7 [applications de bureau | Applications UWP] |
Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau | Applications UWP] |
Plateforme cible | Windows |
En-tête | webservices.h |
Bibliothèque | WebServices.lib |
DLL | WebServices.dll |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour