WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK fonction de rappel (webservices.h)

Article
03/06/2024

Gère l’appel WsCreateChannelForListener pour un WS_CUSTOM_CHANNEL_BINDING.

Syntaxe

WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK WsCreateChannelForListenerCallback;

HRESULT WsCreateChannelForListenerCallback(
  [in]           void *listenerInstance,
                 const void *channelParameters,
  [in]           ULONG channelParametersSize,
                 void **channelInstance,
  [in, optional] WS_ERROR *error
)
{...}

Paramètres

[in] listenerInstance

Pointeur vers l’état propre à cet écouteur instance, tel que créé par le WS_CREATE_LISTENER_CALLBACK.

channelParameters

Pointeur vers la valeur spécifiée par la propriété WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS lorsque le canal personnalisé est créé à l’aide de WsCreateChannelForListener.

Si la propriété WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS n’a pas été spécifiée, la valeur est NULL.

[in] channelParametersSize

Taille en octets de la valeur pointée vers channelParameters.

Si la propriété WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS n’a pas été spécifiée, la taille est 0.

channelInstance

Pointeur vers une structure allouée par le rappel qui contient les données spécifiques à ce canal instance. Ce pointeur sera passé à tous les autres rappels de canal pour ce canal particulier instance.

Si ce rappel réussit, le WS_FREE_CHANNEL_CALLBACK sera utilisé pour libérer le canal instance retourné dans ce paramètre.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Code de retour	Description
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
E_OUTOFMEMORY	Nous avons manqué de mémoire.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

Pour plus d’informations sur le contrat de cette API, consultez WsCreateChannelForListener .

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

Partager via