WS_CREATE_CHANNEL_CALLBACK función de devolución de llamada (webservices.h)

Controla la llamada WsCreateChannel para una WS_CUSTOM_CHANNEL_BINDING.

Sintaxis

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
)
{...}

Parámetros

[in] channelType

Patrón de intercambio de mensajes del canal.

Si el tipo de canal no es compatible con la implementación del canal personalizado, se debe devolver E_INVALIDARG .

channelParameters

Puntero al valor especificado por la propiedad WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS cuando se crea el canal personalizado mediante WsCreateChannel.

Si no se especificó la propiedad WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS , el valor será NULL.

[in] channelParametersSize

Tamaño en bytes del valor al que apunta channelParameters.

Si no se especificó la propiedad WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS , el tamaño será 0.

channelInstance

Puntero a una estructura asignada por la devolución de llamada que contiene los datos específicos de esta instancia de canal. Este puntero se pasará a todas las demás devoluciones de llamada del canal para esta instancia de canal determinada.

Si esta devolución de llamada se realiza correctamente, el WS_FREE_CHANNEL_CALLBACK se usará para liberar la instancia del canal devuelta en este parámetro.

[in, optional] error

Especifica dónde se debe almacenar información de error adicional si se produce un error en la función.

Valor devuelto

Código devuelto	Descripción
E_INVALIDARG	Uno o más argumentos no son válidos.
E_OUTOFMEMORY	Se quedó sin memoria.
Otros errores	Esta función puede devolver otros errores no enumerados anteriormente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	webservices.h