Método External.authenticate

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método authenticate inicia uma tentativa de autenticar o usuário.

Sintaxe

External.authenticate(
  AuthenticationIndex
)

Parâmetros

AuthenticationIndex [in]

Número (longo) que especifica o índice de uma página da Web de sucesso de autenticação.

Retornar valor

Esse método não retorna um valor.

Comentários

Determinados links em uma página de descoberta têm destinos que devem ser exibidos somente após a autenticação do usuário. A página de descoberta, Reprodutor Multimídia do Windows e o plug-in da loja online usam as seguintes etapas para autenticar o usuário e exibir a página da Web de destino:

1. O script em uma página de descoberta chama o Externo. método authenticate .
2. Reprodutor Multimídia do Windows exibe uma caixa de diálogo para obter um nome de usuário e uma senha.
3. Reprodutor Multimídia do Windows chama IWMPContentPartner::Authenticate, que inicia a tentativa de autenticação e retorna imediatamente.
4. Quando a tentativa de autenticação for concluída, o plug-in da loja online chamará IWMPContentPartnerCallback::Notify, passando wmpcnAuthResult e um valor booliano que indica se a tentativa foi bem-sucedida.
5. Se a tentativa de autenticação tiver sido bem-sucedida, Reprodutor Multimídia do Windows chamará IWMPContentPartner::GetItemInfo, passando g_szItemInfo_AuthenticationSuccessURL, para obter a URL de uma página da Web de sucesso de autenticação. Nessa chamada, Reprodutor Multimídia do Windows passa o mesmo índice que a página de descoberta passou para o Externo.método authenticate.
6. Reprodutor Multimídia do Windows exibe a página da Web autenticação-êxito.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows 11
DLL	Wmp.dll

Confira também

Objeto externo para repositórios online do tipo 1

External.attemptLogin

External.userLoggedIn