WsCreateChannelForListener, fonction (webservices.h)
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 |
---|---|
|
Un ou plusieurs arguments ne sont pas valides. |
|
Mémoire insuffisante pour terminer l’opération. |
|
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
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 |
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