WS_CREATE_CHANNEL_CALLBACK fonction de rappel (webservices.h)

Article
03/06/2024

Gère l’appel WsCreateChannel pour un WS_CUSTOM_CHANNEL_BINDING.

Syntaxe

WS_CREATE_CHANNEL_CALLBACK WsCreateChannelCallback;

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

Paramètres

[in] channelType

Modèle d’échange de messages du canal.

Si le type de canal n’est pas pris en charge par l’implémentation de canal personnalisé, E_INVALIDARG doit être retourné.

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

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 par 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 est 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ù des 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	Mémoire insuffisante.
Autres erreurs	Cette fonction peut retourner d’autres erreurs non répertoriées ci-dessus.

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