Compartilhar via

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

  • Artigo

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

Sintaxe

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

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

[in] readCallback

A função que deve ser usada para ler os dados da mensagem. Esse retorno de chamada só deve ser usado em resposta aos retornos de chamada WS_DECODER_START_CALLBACK, WS_DECODER_DECODE_CALLBACK e WS_DECODER_END_CALLBACK .

[in] readContext

O contexto de leitura que deve ser passado para o WS_READ_CALLBACK fornecido.

decoderContext

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

[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 decodificador conforme necessário. Cada instância de decodificador será chamada de maneira única. No entanto, uma única instância de decodificador não deve assumir que verá todas as mensagens de um canal, pois o canal pode usar várias instâncias de decodificador 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