Metode IMFInputTrustAuthority::RequestAccess (mfidl.h)

Artikel
08/24/2023

Meminta izin untuk melakukan tindakan tertentu pada aliran.

Sintaks

HRESULT RequestAccess(
  [in]  MFPOLICYMANAGER_ACTION Action,
  [out] IMFActivate            **ppContentEnablerActivate
);

Parameter

[in] Action

Tindakan yang diminta, ditentukan sebagai anggota enumerasi MFPOLICYMANAGER_ACTION .

[out] ppContentEnablerActivate

Menerima nilai NULL atau penunjuk ke antarmuka IMFActivate . Antarmuka IMFActivate digunakan untuk membuat objek pengaktif konten. Pemanggil harus merilis antarmuka. Untuk informasi selengkapnya, lihat Keterangan.

Menampilkan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Pengguna memiliki izin untuk melakukan tindakan ini.
NS_E_DRM_NEEDS_INDIVIDUALIZATION	Pengguna harus individualisasi aplikasi.
NS_E_LICENSE_REQUIRED	Pengguna harus mendapatkan lisensi.

Keterangan

Metode ini memverifikasi apakah pengguna memiliki izin untuk melakukan tindakan tertentu pada aliran. ITA melakukan pekerjaan apa pun yang diperlukan untuk memverifikasi hak pengguna untuk melakukan tindakan, seperti memeriksa lisensi.

Untuk memverifikasi hak pengguna, ITA mungkin perlu melakukan langkah tambahan yang memerlukan interaksi dengan pengguna atau persetujuan dari pengguna. Misalnya, mungkin perlu memperoleh lisensi baru atau individualisasi komponen DRM. Dalam hal ini, ITA membuat objek aktivasi untuk pengaktif konten dan mengembalikan antarmuka IMFActivate objek aktivasi di parameter ppContentEnablerActivate . Objek aktivasi bertanggung jawab untuk membuat pengaktif konten yang mengekspos antarmuka IMFContentEnabler . Pengaktif konten digunakan sebagai berikut:

Sesi Media mengembalikan penunjuk IMFActivate ke aplikasi.
Aplikasi memanggil IMFActivate::ActivateObject untuk mengaktifkan pengaktif konten.
Aplikasi ini memanggil metode IMFContentEnabler untuk melakukan tindakan apa pun yang diperlukan, seperti individualisasi atau mendapatkan lisensi. Objek pengaktif konten harus merangkum fungsionalitas ini melalui antarmuka IMFContentEnabler .
Sesi Media memanggil RequestAccess lagi.

Nilai yang dikembalikan memberi sinyal apakah pengguna memiliki izin untuk melakukan tindakan:

Jika pengguna sudah memiliki izin untuk melakukan tindakan, metode mengembalikan S_OK dan mengatur *ppContentEnablerActivate ke NULL.
Jika pengguna tidak memiliki izin, metode mengembalikan kode kegagalan dan mengatur *ppContentEnablerActivate ke NULL.
Jika ITA harus melakukan langkah tambahan yang memerlukan interaksi dengan pengguna, metode mengembalikan kode kegagalan dan mengembalikan penunjuk IMFActivate pengaktif konten di ppContentEnablerActivate.

Sesi Media tidak akan mengizinkan tindakan kecuali metode ini mengembalikan S_OK. Namun, nilai pengembalian S_OK tidak menjamin bahwa tindakan akan dilakukan, karena beberapa kegagalan lain mungkin terjadi setelah metode ini dipanggil. Ketika tindakan pasti akan terjadi, Sesi Media memanggil IMFInputTrustAuthority::BindAccess.

Aliran dapat masuk ke beberapa output, sehingga metode ini mungkin dipanggil beberapa kali dengan tindakan yang berbeda, sekali untuk setiap output.

Persyaratan


Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mfidl.h
Pustaka	Mfuuid.lib

Lihat juga

IMFInputTrustAuthority

Bagikan melalui