Compartilhar via

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

  • Artigo

Manipula a chamada WsCreateChannel para um WS_CUSTOM_CHANNEL_BINDING.

Sintaxe

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

O padrão de troca de mensagens do canal.

Se não houver suporte para o tipo de canal pela implementação de canal personalizado, E_INVALIDARG deverá ser retornado.

channelParameters

O ponteiro para o valor especificado pela propriedade WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS quando o canal personalizado é criado usando WsCreateChannel.

Se a propriedade WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS não tiver sido especificada, o valor será NULL.

[in] channelParametersSize

O tamanho em bytes do valor apontado por channelParameters.

Se a propriedade WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS não tiver sido especificada, o tamanho será 0.

channelInstance

Um ponteiro para uma estrutura alocada pelo retorno de chamada que contém os dados específicos para essa instância de canal. Esse ponteiro será passado para todos os outros retornos de chamada de canal para essa instância de canal específica.

Se esse retorno de chamada for bem-sucedido, o WS_FREE_CHANNEL_CALLBACK será usado para liberar a instância de canal retornada nesse parâmetro.

[in, optional] error

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

Retornar valor

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

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