Metode External.authenticate

[Fitur yang terkait dengan halaman ini, Pemutar Media Windows SDK, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer. MediaPlayer telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer alih-alih Pemutar Media Windows SDK, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode autentikasi memulai upaya untuk mengautentikasi pengguna.

Sintaks

External.authenticate(
  AuthenticationIndex
)

Parameter

AuthenticationIndex [in]

Angka (panjang) yang menentukan indeks halaman web keberhasilan autentikasi.

Mengembalikan nilai

Metode ini tidak mengembalikan nilai.

Keterangan

Tautan tertentu pada halaman penemuan memiliki target yang harus ditampilkan hanya setelah pengguna diautentikasi. Halaman penemuan, Pemutar Media Windows, dan plug-in toko online menggunakan langkah-langkah berikut untuk mengautentikasi pengguna dan menampilkan halaman web target:

  1. Skrip pada halaman penemuan memanggil Eksternal. mengautentikasi metode.
  2. Pemutar Media Windows menampilkan kotak dialog untuk mendapatkan nama pengguna dan kata sandi.
  3. Pemutar Media Windows memanggil IWMPContentPartner::Authenticate, yang memulai upaya autentikasi dan segera kembali.
  4. Ketika upaya autentikasi selesai, plug-in toko online memanggil IWMPContentPartnerCallback::Notify, melewati wmpcnAuthResult dan nilai Boolean yang menunjukkan apakah upaya berhasil.
  5. Jika upaya autentikasi berhasil, Pemutar Media Windows memanggil IWMPContentPartner::GetItemInfo, meneruskan g_szItemInfo_AuthenticationSuccessURL, untuk mendapatkan URL halaman web keberhasilan autentikasi. Dalam panggilan ini, Pemutar Media Windows meneruskan indeks yang sama dengan yang diteruskan halaman penemuan ke Eksternal.mengautentikasi metode.
  6. Pemutar Media Windows menampilkan halaman web keberhasilan autentikasi.

Persyaratan

Persyaratan Nilai
Versi
Pemutar Media Windows 11
DLL
Wmp.dll

Lihat juga

Objek Eksternal untuk Toko Online Tipe 1

External.attemptLogin

External.userLoggedIn