Metode IWMDRMSecurity::P erformSecurityUpdate

[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 PerformSecurityUpdate memulai pembaruan keamanan ke subsistem DRM di komputer lokal.

Sintaks

HRESULT PerformSecurityUpdate(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Parameter

dwFlags [in]

Opsi pembaruan dinyatakan sebagai salah satu bendera berikut.

Bendera	Deskripsi
WMDRM_SECURITY_PERFORM_INDIV	Menyebabkan komponen DRM disortir hanya jika versi klien sudah kedaluarsa.
WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH	Menyebabkan daftar pencabutan pada komputer klien diperbarui.
WMDRM_SECURITY_PERFORM_FORCE_INDIV	Menyebabkan komponen DRM disatukan bahkan jika versi klien sudah diperbarui.

ppunkCancelationCookie [out]

Alamat variabel yang menerima penunjuk ke objek yang dapat digunakan untuk membatalkan operasi ini.

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

Metode ini dijalankan secara asinkron. Ini kembali segera setelah dipanggil dan kemudian menghasilkan peristiwa tergantung pada bendera yang diatur dalam parameter dwFlags .

Untuk individualisasi (bendera diatur ke WMDRM_SECURITY_PERFORM_INDIV atau WMDRM_SECURITY_PERFORM_FORCE_INDIV), serangkaian peristiwa MEWMDRMIndividualizationProgress dihasilkan diikuti oleh peristiwa MEWMDRMIndividualizationCompleted saat pemrosesan selesai. Nilai masing-masing peristiwa MEWMDRMIndividualizationProgress yang diperoleh dengan memanggil IMFMediaEvent::GetValue adalah pointer IUnknown . Anda dapat memanggil metode QueryInterface dari antarmuka IUnknown yang diambil untuk mendapatkan instans antarmuka IWMDRMIndividualizationStatus .

Untuk me-refresh daftar pencabutan (bendera diatur ke WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH), peristiwa MEWMDRMREvocationDownloadCompleted dihasilkan saat pemrosesan selesai.

Catatan

Ketika PerformSecurityUpdate menyelesaikan individualisasi, satu-satunya objek yang ada yang akan mencerminkan status individual baru adalah objek yang mewarisi dari IWMDRMSecurity. Semua objek lain yang ada tidak akan diperbarui. Anda harus melepaskan dan membuat ulang objek lain sehingga objek tersebut akan mencerminkan status individual baru.

Untuk informasi selengkapnya tentang menggunakan metode asinkron WINDOWS Media DRM Client Extended API, lihat Menggunakan Media Foundation Event Model.

Persyaratan

Persyaratan	Nilai
Header	Wmdrmsdk.h
Pustaka	Wmdrmsdk.lib

Lihat juga

Pencabutan dan Perpanjangan Komponen Otomatis

Contoh Individualisasi DRM

Antarmuka Keamanan IWMDRM

Melakukan Individualisasi DRM