WsCreateChannelForListener, fonction (webservices.h)

Article
03/03/2024

Crée un canal associé à un écouteur spécifié.

Syntaxe

HRESULT WsCreateChannelForListener(
  [in]           WS_LISTENER               *listener,
                 const WS_CHANNEL_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_CHANNEL                **channel,
  [in, optional] WS_ERROR                  *error
);

Paramètres

[in] listener

Pointeur vers une structure WS_LISTENER représentant l’écouteur pour lequel créer un canal. L’écouteur peut être dans n’importe quel état. (Pour connaître les états de l’écouteur, consultez l’énumération WS_LISTENER_STATE .)

properties

Tableau de structures WS_CHANNEL_PROPERTY contenant des valeurs facultatives pour l’initialisation de canal. Il peut s’agir d’une valeur NULL, auquel cas, le paramètre propertyCount doit être égal à 0 (zéro).

Pour plus d’informations sur la création d’un canal personnalisé, consultez la section Remarques.

[in] propertyCount

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

channel

En cas de réussite, pointeur qui reçoit l’adresse du canal créé.
Lorsque le canal n’est plus nécessaire, vous devez le libérer en appelant WsFreeChannel.

[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.

Code de retour	Description
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

Pour accepter un échange de messages entrants, appelez la fonction WsAcceptChannel .

Les caractéristiques de sécurité du canal sont les mêmes que celles spécifiées pour l’écouteur.

Lorsque vous créez un canal personnalisé (à l’aide de la valeur WS_CUSTOM_CHANNEL_BINDING de l’énumération WS_CHANNEL_BINDING ), vous pouvez spécifier uniquement les propriétés de canal suivantes :

WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS

Si des propriétés initiales sont requises pour créer le canal personnalisé, spécifiez-les à l’aide de la propriété WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	webservices.h
Bibliothèque	WebServices.lib
DLL	WebServices.dll

Partager via