Função WsOpenServiceProxy (webservices.h)

Abre um Proxy de Serviço para um ponto de extremidade de serviço.

Em aplicativos cliente bem-sucedidos podem fazer chamadas usando o Proxy de Serviço. O comportamento de WsOpenServiceProxy é regido pela associação de canal usada.

Sintaxe

HRESULT WsOpenServiceProxy(
  [in]           WS_SERVICE_PROXY          *serviceProxy,
  [in]           const WS_ENDPOINT_ADDRESS *address,
  [in, optional] const WS_ASYNC_CONTEXT    *asyncContext,
  [in, optional] WS_ERROR                  *error
);

Parâmetros

[in] serviceProxy

Um ponteiro para o Proxy de Serviço a ser aberto. O ponteiro deve referenciar um objeto WS_SERVICE_PROXY válido e o valor referenciado pode não ser NULL.

[in] address

Um ponteiro para o endereço do ponto de extremidade.

[in, optional] asyncContext

Um ponteiro para um objeto WS_ASYNC_CONTEXT que tem informações sobre como invocar a função de forma assíncrona. O valor será definido como NULL se invocar de forma síncrona.

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o 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
WS_S_ASYNC	A operação assíncrona ainda está pendente.
WS_E_OPERATION_ABORTED	A operação foi anulada.
WS_E_INVALID_OPERATION	A operação não é permitida devido ao estado atual do objeto.
WS_E_ENDPOINT_NOT_FOUND	O ponto de extremidade remoto não existe ou não pôde ser localizado.
WS_E_ENDPOINT_ACCESS_DENIED	O acesso foi negado pelo ponto de extremidade remoto.
WS_E_ENDPOINT_DISCONNECTED	A conexão com o ponto de extremidade remoto foi encerrada.
WS_E_ENDPOINT_FAILURE	O ponto de extremidade remoto não pôde processar a solicitação.
WS_E_ENDPOINT_NOT_AVAILABLE	O ponto de extremidade remoto não está atualmente em serviço neste local.
WS_E_ENDPOINT_TOO_BUSY	O ponto de extremidade remoto não pode processar a solicitação devido à sobrecarga.
WS_E_ENDPOINT_UNREACHABLE	O ponto de extremidade remoto não estava acessível.
WS_E_INVALID_ENDPOINT_URL	A URL do endereço do ponto de extremidade é inválida.
WS_E_INVALID_FORMAT	Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.
WS_E_OPERATION_TIMED_OUT	A operação não foi concluída dentro do tempo alocado.
WS_E_PROXY_ACCESS_DENIED	O acesso foi negado pelo servidor proxy HTTP.
WS_E_PROXY_FAILURE	O servidor proxy HTTP não pôde processar a solicitação.
WS_E_QUOTA_EXCEEDED	Uma cota foi excedida.
WS_E_SECURITY_VERIFICATION_FAILURE	A verificação de segurança não foi bem-sucedida para os dados recebidos.
WS_E_SECURITY_SYSTEM_FAILURE	Falha em uma operação de segurança na estrutura dos Serviços Web do Windows.
WS_E_PROXY_REQUIRES_BASIC_AUTH	O servidor proxy HTTP requer o esquema de autenticação HTTP 'basic'.
WS_E_PROXY_REQUIRES_DIGEST_AUTH	O servidor proxy HTTP requer o esquema de autenticação HTTP 'digest'.
WS_E_PROXY_REQUIRES_NEGOTIATE_AUTH	O servidor proxy HTTP requer o esquema de autenticação HTTP 'negotiate'.
WS_E_PROXY_REQUIRES_NTLM_AUTH	O servidor proxy HTTP requer o esquema de autenticação HTTP 'NTLM'.
WS_E_SERVER_REQUIRES_BASIC_AUTH	O ponto de extremidade remoto requer o esquema de autenticação HTTP 'básico'.
WS_E_SERVER_REQUIRES_DIGEST_AUTH	O ponto de extremidade remoto requer o esquema de autenticação HTTP 'digest'.
WS_E_SERVER_REQUIRES_NEGOTIATE_AUTH	O ponto de extremidade remoto requer o esquema de autenticação HTTP 'negotiate'.
WS_E_SERVER_REQUIRES_NTLM_AUTH	O ponto de extremidade remoto requer o esquema de autenticação HTTP 'NTLM'.
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.

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