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

Controla la creación de una instancia de codificador.

Sintaxis

WS_CREATE_ENCODER_CALLBACK WsCreateEncoderCallback;

HRESULT WsCreateEncoderCallback(
  [in]           void *createContext,
  [in]           WS_WRITE_CALLBACK writeCallback,
  [in]           void *writeContext,
                 void **encoderContext,
  [in, optional] WS_ERROR *error
)
{...}

Parámetros

[in] createContext

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

[in] writeCallback

Función que se debe usar para escribir los datos del mensaje. Esta devolución de llamada solo se debe usar en respuesta al WS_ENCODER_START_CALLBACK, WS_ENCODER_ENCODE_CALLBACK y WS_ENCODER_END_CALLBACK devoluciones de llamada.

[in] writeContext

Contexto de escritura que se debe pasar al WS_WRITE_CALLBACK proporcionado.

encoderContext

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

[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 del codificador según sea necesario. Se llamará a cada instancia del codificador de forma uniproceso. Sin embargo, una sola instancia de codificador no debe suponer que verá todos los mensajes de un canal, ya que el canal puede usar varias instancias de codificador 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