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

  • Artigo
  • 2 minutos para o fim da leitura

Manipula a chamada WsGetChannelProperty para um WS_CUSTOM_CHANNEL_BINDING.

Sintaxe

WS_GET_CHANNEL_PROPERTY_CALLBACK WsGetChannelPropertyCallback;

HRESULT WsGetChannelPropertyCallback(
  [in]           void *channelInstance,
  [in]           WS_CHANNEL_PROPERTY_ID id,
                 void *value,
  [in]           ULONG valueSize,
  [in, optional] WS_ERROR *error
)
{...}

Parâmetros

[in] channelInstance

O ponteiro para o estado específico para essa instância de canal, conforme criado pelo WS_CREATE_CHANNEL_CALLBACK.

[in] id

A ID da propriedade a ser recuperada.

value

O local para armazenar a propriedade recuperada. O ponteiro deve ter um alinhamento compatível com o tipo da propriedade.

[in] valueSize

O número de bytes alocados pelo chamador para armazenar a propriedade recuperada.

[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
 Não havia suporte para a ID da propriedade para esse objeto ou o buffer especificado não era grande o suficiente para o valor.
E_OUTOFMEMORY
 Ficou sem memória.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Consulte WsGetChannelProperty para obter informações sobre o contrato desta API.

Cada implementação de canal personalizado deve dar suporte ao retorno de um valor para pelo menos as seguintes propriedades:

A camada modelo de serviço fornece sua própria lógica de tempos limite de chamada, como tal, requer a desabilitação de tempos limite no canal subjacente. Para que um canal personalizado seja usado na camada do Modelo de Serviço, ele deve dar suporte à desabilitação de todos os seus tempos limite e implementar esse retorno de chamada para WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS. Um canal personalizado não pode ser usado por meio do Modelo de Serviço, a menos que a consulta para WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS retorne FALSE.

Cabe à implementação de canal personalizado determinar as propriedades adicionais que deseja dar suporte.

Se não houver suporte para uma propriedade, a E_INVALIDARG deverá ser retornada. (Consulte valores retornados dos Serviços Web do Windows.)

Requisitos

   
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