Evento External.OnLoginChange

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Nota

Questo argomento descrive le funzionalità progettate per l'uso da parte degli archivi online. L'uso di questa funzionalità al di fuori del contesto di un archivio online non è supportato.

L'evento OnLoginChange si verifica quando lo stato di accesso dell'utente cambia o quando un tentativo di accesso ha esito negativo.

window.external.OnLoginChange = FunctionName

Valori possibili

Questa è una proprietà di sola scrittura che specifica il nome della funzione nello script che Lettore multimediale Windows chiama quando si verifica l'evento.

Parametri

La funzione che gestisce questo evento non accetta parametri.

Commenti

Questo evento si verifica ogni volta che il plug-in dell'archivio online chiama IWMPContentPartnerCallback::Notify, passando wmpcnLoginStateChange nel parametro di tipo . A volte il plug-in effettua questa chiamata per notificare Lettore multimediale Windows che è stata apportata una modifica nello stato di accesso dell'utente. Altre volte, il plug-in effettua questa chiamata per notificare al lettore che un tentativo di accesso non è riuscito. Il parametro pContext del metodo Notify specifica se la notifica è per una modifica dello stato di accesso o per un tentativo di accesso non riuscito.

Poiché ogni chiamata a Notify(wmpcnLoginStateChange, ...) causa di Lettore multimediale Windows genera l'evento OnLoginChange, il gestore eventi OnLoginChange viene chiamato a volte come risultato di una modifica dello stato di accesso e talvolta come risultato di un tentativo di accesso non riuscito. Per determinare lo stato di accesso corrente dell'utente, il gestore eventi OnLoginChange deve chiamare External.userLoggedIn.

Requisiti

Requisito Valore
Versione
Lettore multimediale Windows 11
DLL
Wmp.dll

Vedi anche

Oggetto esterno per i tipi 1 archivi online

External.attemptLogin

External.userLoggedIn