WsCreateMessageForChannel, fonction (webservices.h)

Crée un message à utiliser avec un canal spécifié.

Syntaxe

HRESULT WsCreateMessageForChannel(
  [in]           WS_CHANNEL                *channel,
                 const WS_MESSAGE_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_MESSAGE                **message,
  [in, optional] WS_ERROR                  *error
);

Paramètres

[in] channel

Pointeur vers une structure WS_CHANNEL représentant le canal du message.

properties

Tableau de propriétés facultatives pour le message. Voir WS_MESSAGE_PROPERTY.

La valeur de ce paramètre peut être NULL, auquel cas, le paramètre propertyCount doit être égal à 0 (zéro).

[in] propertyCount

Nombre de propriétés dans le tableau de propriétés .

message

En cas de réussite, un pointeur qui reçoit l’adresse du WS_MESSAGE structure représentant le nouveau message.

Lorsque vous n’avez plus besoin de cette structure, vous devez la libérer en appelant WsFreeMessage.

[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

Contrairement à la fonction WsCreateMessage plus générale, WsCreateMessageForChannel garantit que la version de message utilisée est appropriée pour le canal.

Configuration requise