Compartilhar via


Método IUpdateEndpointAuthProvider::GetEndpointToken

Solicite um token para o ponto de extremidade do serviço usando as credenciais especificadas.

Sintaxe

HRESULT GetEndpointToken(
  [in]  GUID                        serviceId,
  [in]  UpdateEndpointType          endpointType,
  [in]  UpdateEndpointProxySettings proxySettings,
  [in]  HANDLE_PTR                  hUserToken,
  [in]  UpdateEndpointAuthTokenType tokenType,
  [in]  BOOL                        fRefreshOnline,
  [out] IUnknown                    **ppEndpointToken
);

Parâmetros

serviceId [in]

Identifica o serviço a ser atualizado.

endpointType [in]

Identifica o tipo de ponto de extremidade que é implementado pelo serviço.

proxySettings [in]

As configurações a serem usadas ao se conectar a um servidor proxy. Consulte a estrutura UpdateEndpointProxySettings para obter mais detalhes.

hUserToken [in]

tokenType [in]

Identifica o tipo de token de autenticação usado para autenticação.

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.

ppEndpointToken [out]

Especifique o token de ponto de extremidade a ser usado.

Valor retornado

Retorna S_OK se houver ê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, se ocorrer um erro de conexão, o WUA define esse parâmetro como true quando o método é 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.

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
UpdateEndpointAuth.h
IDL
UpdateEndpointAuth.idl
Biblioteca
UpdateEndpointAuth.lib
DLL
UpdateEndpointAuth.dll

Confira também

IUpdateEndpointAuthProvider