Método IUpdateEndpointProvider::GetServiceEndpoint
Solicita um ponto de extremidade usado para se conectar a um serviço.
Sintaxe
HRESULT GetServiceEndpoint(
[in] GUID ServiceId,
[in] UpdateEndpointType endpointType,
[in] UpdateEndpointProxySettings proxySettings,
[in] HANDLE_PTR hUserToken,
[in] BOOL fRefreshOnline,
[out] BSTR *pbstrEndpointLoc
);
Parâmetros
-
ServiceId [in]
-
Identifica o serviço a ser atualizado.
-
endpointType [in]
-
Identifica o tipo de ponto de extremidade implementado pelo serviço.
A enumeração UpdateEndpointType define as seguintes constantes.
-
uetClientServer
-
Um ponto de extremidade cliente-servidor usado para se conectar ao serviço de atualização.
-
uetReporting
-
Um ponto de extremidade de relatório usado quando o cliente relata os resultados de verificações, downloads e instalações de volta ao serviço de atualização
-
uetWuaSelfUpdate
-
Um ponto de extremidade de autoatualização que é usado quando o computador cliente entra em contato com um serviço de atualização para ver se há uma nova versão do software cliente do agente do Windows Update.
-
uetRegulation
-
Um ponto de extremidade de regulamentação que é usado quando o computador cliente entra em contato com o serviço de regulamentação para realizar ações em uma atualização específica aplicável ao computador de destino.
-
uetSimpleTargeting
-
Um ponto de extremidade de direcionamento simples que é usado apenas com serviços privados (servidores WSUS em ambientes corporativos).
proxySettings [in]
Identifica as configurações usadas ao se conectar a um servidor proxy.
hUserToken [in]
Contém um objeto de identificador de token que representa o usuário. O provedor de ponto de extremidade usa esse token para determinar quais configurações e credenciais de proxy usar.
fRefreshOnline [in]
Indica se WUA solicita um novo token. True indica que um novo token é solicitado. False indica que um token novo ou armazenado em cache é solicitado. Confira Comentários para obter mais informações.
pbstrEndpointLoc [out]
Especifique a URL usada para se comunicar com o serviço. Por exemplo, para um ponto de extremidade cliente-servidor, esta seria a URL para o serviço de servidor cliente. Confira Comentários para obter mais informações.
Valor retornado
Retorna S_OK se tiver êxito. Caso contrário, retorna um código de erro COM ou Windows.
Comentários
O WUA normalmente define o parâmetro fRefreshOnline como false quando esse método é chamado pela primeira vez e, em seguida, se ocorrer um erro de conexão, o WUA definirá esse parâmetro como true quando o método for chamado novamente. No entanto, a implementação desse método pode solicitar um novo token de um STS (Serviço de Token de Segurança) ou fornecer um token armazenado em cache a qualquer momento.
Se o ponto de extremidade não precisar de autenticação, o chamador poderá se conectar ao serviço usando apenas a URL especificada pelo parâmetro pbstrEndpointLoc.
Se o ponto de extremidade precisar de autenticação, o chamador poderá usar a URL especificada pelo parâmetro pbstrEndpointLoc e os dados fornecidos pelos outros parâmetros.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP, Windows 2000 Professional com SP3 [somente aplicativos de desktop] |
| Servidor mínimo com suporte |
Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos de desktop] |
| Cabeçalho |
|
| IDL |
|
| Biblioteca |
|
| DLL |
|
Confira também