Fonction WsAddCustomHeader (webservices.h)

Ajoute l’en-tête défini par l’application spécifié au message.

Syntaxe

HRESULT WsAddCustomHeader(
  [in]           WS_MESSAGE                   *message,
  [in]           const WS_ELEMENT_DESCRIPTION *headerDescription,
  [in]           WS_WRITE_OPTION              writeOption,
  [in, ref]      const void                   *value,
  [in]           ULONG                        valueSize,
  [in]           ULONG                        headerAttributes,
  [in, optional] WS_ERROR                     *error
);

Paramètres

[in] message

Message auquel ajouter l’en-tête.

Le message peut être dans n’importe quel état , à l’exception de WS_MESSAGE_STATE_EMPTY (consultez l’énumération WS_MESSAGE_STATE ..

[in] headerDescription

Structure WS_ELEMENT_DESCRIPTION qui décrit l’en-tête.

[in] writeOption

Indique si l’élément d’en-tête est requis et comment la valeur est allouée. Pour plus d’informations, consultez l’énumération WS_WRITE_OPTION .

[in, ref] value

Valeur d’en-tête à sérialiser. Pour plus d’informations, consultez l’énumération WS_WRITE_OPTION .

[in] valueSize

Taille de la valeur sérialisée, en octets.

[in] headerAttributes

Valeurs des attributs SOAP pour l’en-tête.

[in, optional] error

Pointeur vers une structure de WS_ERROR qui reçoit des informations d’erreur supplémentaires en cas d’échec de la fonction.

Valeur retournée

Si la fonction réussit, elle retourne NO_ERROR ; sinon, il retourne un code d’erreur HRESULT.

Remarques

La fonction WsAddCustomHeader est conçue pour gérer les types d’en-têtes ciblant le récepteur final. Les en-têtes ciblant un autre récepteur sont ignorés.

Si vous remplacez un en-tête, appelez la fonction WsRemoveCustomHeader pour supprimer les instances existantes de l’en-tête avant d’appeler WsAddCustomHeader.

Configuration requise