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

Controla la creación de una instancia de descodificador.

Sintaxis

WS_CREATE_DECODER_CALLBACK WsCreateDecoderCallback;

HRESULT WsCreateDecoderCallback(
  [in]           void *createContext,
  [in]           WS_READ_CALLBACK readCallback,
  [in]           void *readContext,
                 void **decoderContext,
  [in, optional] WS_ERROR *error
)
{...}

Parámetros

[in] createContext

CreateContext que se especificó en el WS_CHANNEL_DECODER usado durante la creación del canal.

[in] readCallback

Función que se debe usar para leer los datos del mensaje. Esta devolución de llamada solo se debe usar en respuesta al WS_DECODER_START_CALLBACK, WS_DECODER_DECODE_CALLBACK y WS_DECODER_END_CALLBACK devoluciones de llamada.

[in] readContext

Contexto de lectura que se debe pasar al WS_READ_CALLBACK proporcionado.

decoderContext

Devuelve la instancia del descodificador. Este valor se pasará a todas las devoluciones de llamada del descodificador.

[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

Esta función de devolución de llamada puede devolver uno de estos valores.

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

Comentarios

El canal creará instancias de descodificador según sea necesario. Se llamará a cada instancia de descodificador de forma uniproceso. Sin embargo, una única instancia de descodificador no debe suponer que verá todos los mensajes de un canal, ya que el canal puede usar varias instancias de descodificador para procesar mensajes.

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