struktur MFP_ACQUIRE_USER_CREDENTIAL_EVENT (mfplay.h)

  • Artikel
Penting Usang. API ini dapat dihapus dari rilis Windows di masa mendatang. Aplikasi harus menggunakan Sesi Media untuk pemutaran.
 

Struktur peristiwa untuk peristiwa MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL . Kejadian ini dikirim jika aplikasi memutar file media dari server yang memerlukan autentikasi. Aplikasi dapat merespons dengan memberikan kredensial pengguna.

Sintaks

typedef struct MFP_ACQUIRE_USER_CREDENTIAL_EVENT {
  MFP_EVENT_HEADER     header;
  DWORD_PTR            dwUserData;
  BOOL                 fProceedWithAuthentication;
  HRESULT              hrAuthenticationStatus;
  LPCWSTR              pwszURL;
  LPCWSTR              pwszSite;
  LPCWSTR              pwszRealm;
  LPCWSTR              pwszPackage;
  LONG                 nRetries;
  MFP_CREDENTIAL_FLAGS flags;
  IMFNetCredential     *pCredential;
} MFP_ACQUIRE_USER_CREDENTIAL_EVENT;

Anggota

header

MFP_EVENT_HEADER struktur yang berisi data umum untuk semua peristiwa IMFPMediaPlayer .

dwUserData

Data pengguna yang ditentukan aplikasi untuk item media. Nilai ini ditentukan ketika aplikasi memanggil IMFPMediaPlayer::CreateMediaItemFromURL atau IMFPMediaPlayer::CreateMediaItemFromObject untuk membuat item media.

Kejadian ini dikirim (jika sama sekali) sebelum item media dibuat dan sebelum aplikasi menerima peristiwa MFP_EVENT_TYPE_MEDIAITEM_CREATED . Anda dapat menggunakan nilai dwUserData untuk mengidentifikasi item media mana yang memerlukan autentikasi.

fProceedWithAuthentication

Aplikasi harus mengatur anggota ini ke TRUE atau FALSE sebelum kembali dari panggilan balik peristiwa IMFPMediaPlayerCallback::OnMediaPlayerEvent .

Jika nilainya TRUE saat panggilan balik kembali, MFPlay melanjutkan upaya autentikasi. Jika tidak, autentikasi gagal.

hrAuthenticationStatus

Kode respons tantangan autentikasi.

pwszURL

URL asli yang memerlukan autentikasi.

pwszSite

Nama situs atau proksi yang memerlukan autentikasi.

pwszRealm

Nama alam untuk autentikasi ini.

pwszPackage

Nama paket autentikasi, seperti "Digest" atau "MBS_BASIC".

nRetries

Jumlah percobaan ulang. Anggota ini diatur ke nol pada upaya pertama, dan ditambahkan sekali untuk setiap upaya berikutnya.

flags

Bitwise OR dari nol atau lebih bendera dari enumerasi _MFP_CREDENTIAL_FLAGS .

pCredential

Arahkan ke antarmuka IMFNetCredential . Aplikasi menggunakan antarmuka ini untuk mengatur kredensial pengguna.

Keterangan

Untuk mendapatkan penunjuk ke struktur ini, transmisikan parameter pEventHeader dari metode panggilan balik IMFPMediaPlayerCallback::OnMediaPlayerEvent . Anda dapat menggunakan makro MFP_GET_ACQUIRE_USER_CREDENTIAL_EVENT untuk tujuan ini.

Jika anggota bendera berisi bendera MFP_CREDENTIAL_PROMPT , aplikasi harus melakukan hal berikut:

  1. Minta pengguna untuk memasukkan nama pengguna dan kata sandi.
  2. Simpan nama pengguna di objek kredensial dengan memanggil IMFNetCredential::SetUser pada penunjuk pCredential .
  3. Simpan kata sandi dengan memanggil IMFNetCredential::SetPassword pada penunjuk pCredential .
Untuk membatalkan autentikasi, atur fProceedWithAuthentication sama dengan FALSE.

Secara default, MFPlay menggunakan implementasi sumber jaringan IMFNetCredentialManager untuk mengelola kredensial. Aplikasi dapat menyediakan implementasinya sendiri dari antarmuka ini sebagai berikut:

  1. Panggil QueryInterface pada penunjuk IMFPMediaPlayer untuk mendapatkan antarmuka IPropertyStore .
  2. Panggil IPropertyStore::SetValue untuk mengatur properti MFNETSOURCE_CREDENTIAL_MANAGER .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Header mfplay.h

Lihat juga

IMFPMediaPlayerCallback

Struktur Media Foundation

Menggunakan MFPlay untuk Pemutaran Audio/Video