Metode IWMDRMSecurity::GetContentEnablersFromHashes

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

Metode GetContentEnablersFromHashes mengambil antarmuka pengaktif konten yang memungkinkan perpanjangan komponen berdasarkan sertifikat yang di-hash.

Sintaks

HRESULT GetContentEnablersFromHashes(
  [in]      BSTR              *rgpbCertHashes,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Parameter

rgpbCertHashes [in]

Array hash sertifikat untuk mendapatkan pengaktif konten.

cCerts [in]

Jumlah sertifikat untuk mengambil pengaktif konten. Ini adalah jumlah elemen dalam array rgpbCertHashes .

hResultHint [in]

Mengembalikan nilai yang diterima dari operasi yang gagal karena sertifikat yang dicabut. Jika Anda tidak memanggil sebagai respons terhadap panggilan metode yang gagal, atur ke S_OK.

prgContentEnablers [out]

Array yang menerima alamat antarmuka IMFContentEnabler yang baru dibuat. Atur ke NULL untuk mendapatkan jumlah pengaktif konten di parameter pcContentEnablers .

pcContentEnablers [masuk, keluar]

Jumlah elemen dalam array prgContentEnablers . Jika prgContentEnablers adalah NULL, nilai ini diatur ke jumlah pengaktif konten yang diperlukan pada output.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Jika Anda menggunakan antarmuka IMFContentEnabler untuk memperbarui komponen yang dicabut, Anda harus mengklarifikasi proses kepada pengguna. Klarifikasi ini harus dilakukan karena proses pembaruan mengirimkan informasi dari komputer klien ke situs Web Microsoft.

Saat Anda memanggil IMFContentEnabler::AutomaticEnable, pengaktif konten meluncurkan browser default dengan alamat layanan pembaruan di situs Web Microsoft. Pengidentifikasi unik yang mengidentifikasi komponen yang dicabut dikirim ke layanan pembaruan. Layanan kemudian mengalihkan browser ke halaman Web tempat pengguna mungkin dapat mengunduh dan menginstal versi baru komponen yang dicabut.

Persyaratan

Persyaratan	Nilai
Header	Wmdrmsdk.h
Pustaka	Wmdrmsdk.lib

Lihat juga

Antarmuka Keamanan IWMDRM