Compartilhar via

WS_CREATE_ENCODER_CALLBACK função de retorno de chamada (webservices.h)

  • Artigo

Manipula a criação de uma instância do codificador.

Sintaxe

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

O createContext especificado no WS_CHANNEL_ENCODER usado durante a criação do canal.

[in] writeCallback

A função que deve ser usada para gravar os dados da mensagem. Esse retorno de chamada só deve ser usado em resposta aos retornos de chamada WS_ENCODER_START_CALLBACK, WS_ENCODER_ENCODE_CALLBACK e WS_ENCODER_END_CALLBACK .

[in] writeContext

O contexto de gravação que deve ser passado para o WS_WRITE_CALLBACK fornecido.

encoderContext

Retorna a instância do codificador. Esse valor será passado para todos os retornos de chamada do codificador.

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Retornar valor

Essa função de retorno de chamada pode retornar um desses valores.

Código de retorno Descrição
E_OUTOFMEMORY
 Ficou sem memória.
E_INVALIDARG
 Um ou mais argumentos são inválidos.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

O canal criará instâncias de codificador conforme necessário. Cada instância do codificador será chamada de maneira única. No entanto, uma única instância de codificador não deve assumir que verá todas as mensagens de um canal, pois o canal pode usar várias instâncias de codificador para processar mensagens.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho webservices.h