Evento External.OnLoginChange

[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.]

Observação

Este tópico descreve a funcionalidade projetada para uso por lojas online. Não há suporte para o uso dessa funcionalidade fora do contexto de um repositório online.

O evento OnLoginChange ocorre quando o logon do usuário status é alterado ou quando uma tentativa de logon falha.

window.external.OnLoginChange = FunctionName

Valores possíveis

Essa é uma propriedade somente gravação que especifica o nome da função no script que Reprodutor Multimídia do Windows chama quando o evento ocorre.

Parâmetros

A função que manipula esse evento não usa parâmetros.

Comentários

Esse evento ocorre sempre que o plug-in da loja online chama IWMPContentPartnerCallback::Notify, passando wmpcnLoginStateChange no parâmetro type . Às vezes, o plug-in faz essa chamada para notificar Reprodutor Multimídia do Windows que houve uma alteração no estado de logon do usuário. Outras vezes, o plug-in faz essa chamada para notificar o Player de que uma tentativa de logon falhou. O parâmetro pContext do método Notify especifica se a notificação é para uma alteração do estado de logon ou para uma tentativa de logon com falha.

Como cada chamada para Notify(wmpcnLoginStateChange, ...) faz com que Reprodutor Multimídia do Windows acione o evento OnLoginChange, o manipulador de eventos OnLoginChange é chamado às vezes como resultado de uma alteração no estado de logon e, às vezes, como resultado de uma tentativa de logon com falha. Para determinar o estado de logon atual do usuário, o manipulador de eventos OnLoginChange deve chamar External.userLoggedIn.

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