Metodo External.authenticate

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di 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.

Il metodo di autenticazione avvia un tentativo di autenticazione dell'utente.

Sintassi

External.authenticate(
  AuthenticationIndex
)

Parametri

AuthenticationIndex [in]

Numero (long) che specifica l'indice di una pagina Web authentication-success.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Alcuni collegamenti in una pagina di individuazione hanno destinazioni che devono essere visualizzate solo dopo l'autenticazione dell'utente. La pagina di individuazione, Lettore multimediale Windows e il plug-in dello store online usano la procedura seguente per autenticare l'utente e visualizzare la pagina Web di destinazione:

1. Lo script in una pagina di individuazione chiama External. metodo di autenticazione .
2. Lettore multimediale Windows visualizza una finestra di dialogo per ottenere un nome utente e una password.
3. Lettore multimediale Windows chiama IWMPContentPartner::Authenticate, che avvia il tentativo di autenticazione e restituisce immediatamente.
4. Al termine del tentativo di autenticazione, il plug-in dell'archivio online chiama IWMPContentPartnerCallback::Notify, passando wmpcnAuthResult e un valore booleano che indica se il tentativo ha avuto esito positivo.
5. Se il tentativo di autenticazione ha avuto esito positivo, Lettore multimediale Windows chiama IWMPContentPartner::GetItemInfo, passando g_szItemInfo_AuthenticationSuccessURL, per ottenere l'URL di una pagina Web con autenticazione riuscita. In questa chiamata Lettore multimediale Windows passa lo stesso indice passato alla pagina di individuazione esterna.metodo di autenticazione.
6. Lettore multimediale Windows visualizza la pagina Web authentication-success.

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows 11
DLL	Wmp.dll

Vedi anche

Oggetto esterno per gli archivi online di tipo 1

External.attemptLogin

External.userLoggedIn