Compartir a través de

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

  • Artículo

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