Função WsOpenChannel (webservices.h)
Abra um canal para um ponto de extremidade.
Sintaxe
HRESULT WsOpenChannel(
[in] WS_CHANNEL *channel,
[in] const WS_ENDPOINT_ADDRESS *endpointAddress,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
Parâmetros
[in] channel
O canal a ser aberto.
[in] endpointAddress
O endereço do ponto de extremidade.
[in, optional] asyncContext
Informações sobre como invocar a função de forma assíncrona ou NULL se estiver invocando de forma síncrona.
[in, optional] error
Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.
Retornar valor
Essa função pode retornar um desses valores.
Código de retorno | Descrição |
---|---|
|
A operação assíncrona ainda está pendente. |
|
A operação foi anulada. |
|
A operação não é permitida devido ao estado atual do objeto. |
|
O ponto de extremidade remoto não existe ou não pôde ser localizado. |
|
O acesso foi negado pelo ponto de extremidade remoto. |
|
A conexão com o ponto de extremidade remoto foi encerrada. |
|
O ponto de extremidade remoto não pôde processar a solicitação. |
|
O ponto de extremidade remoto não está atualmente em serviço neste local. |
|
O ponto de extremidade remoto não pode processar a solicitação devido à sobrecarga. |
|
O ponto de extremidade remoto não estava acessível. |
|
A URL do endereço do ponto de extremidade é inválida. |
|
Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado. |
|
A operação não foi concluída dentro do tempo alocado. |
|
O acesso foi negado pelo servidor proxy HTTP. |
|
O servidor proxy HTTP não pôde processar a solicitação. |
|
Uma cota foi excedida. |
|
A verificação de segurança não foi bem-sucedida para os dados recebidos. |
|
Falha em uma operação de segurança na estrutura dos Serviços Web do Windows. |
|
O servidor proxy HTTP requer o esquema de autenticação HTTP 'basic'. |
|
O servidor proxy HTTP requer o esquema de autenticação HTTP 'digest'. |
|
O servidor proxy HTTP requer o esquema de autenticação HTTP 'negotiate'. |
|
O servidor proxy HTTP requer o esquema de autenticação HTTP 'NTLM'. |
|
O ponto de extremidade remoto requer o esquema de autenticação HTTP 'básico'. |
|
O ponto de extremidade remoto requer o esquema de autenticação HTTP 'digest'. |
|
O ponto de extremidade remoto requer o esquema de autenticação HTTP 'negotiate'. |
|
O ponto de extremidade remoto requer o esquema de autenticação HTTP 'NTLM'. |
|
Ficou sem memória. |
|
Um ou mais argumentos são inválidos. |
|
Essa função pode retornar outros erros não listados acima. |
Comentários
Se a abertura for bem-sucedida, o canal deverá ser fechado usando WsCloseChannel antes de ser liberado.
Use WsCreateChannel para criar o canal.
Depois que um canal é aberto para um ponto de extremidade, toda a comunicação ocorre com esse ponto de extremidade.
O endereço do ponto de extremidade e seu conteúdo não são necessários após o retorno da função, mesmo que a função seja invocada de forma assíncrona (por exemplo, ela pode ser declarada com segurança na pilha).
Se alguma E/S realmente ocorrer durante essa chamada dependerá do tipo de canal e de suas configurações.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
Servidor mínimo com suporte | Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
Plataforma de Destino | Windows |
Cabeçalho | webservices.h |
Biblioteca | WebServices.lib |
DLL | WebServices.dll |