Metode IWMDRMDeviceApp::AcquireDeviceData

Artikel
06/12/2023

Metode AcquireDeviceData menginisialisasi atau mengatur ulang jam aman perangkat.

Sintaks

HRESULT AcquireDeviceData(
  [in]  IWMDMDevice    *pDevice,
  [in]  IWMDMProgress3 *pProgressCallback,
  [in]  DWORD          dwFlags,
  [out] DWORD          *pdwStatus
);

Parameter

pDevice [in]

Penunjuk ke antarmuka IWMDMDevice untuk perangkat yang akan melaporkan data pengukuran.

pProgressCallback [in]

Progres panggilan balik di mana aplikasi dapat melacak kemajuan peristiwa, atau membatalkan peristiwa. Kemajuan diidentifikasi oleh parameter EventId metode IWMDMProgress3 .

dwFlags [in]

LOGIS ATAU dari salah satu atau kedua bendera berikut, menentukan tindakan apa yang harus dilakukan. Nilai ini diambil dari parameter pdwStatus dari IWMDRMDeviceApp::QueryDeviceStatus atau IWMDRMDeviceApp2::QueryDeviceStatus2. Anda dapat menggunakan bendera pdwStatus secara langsung.

Bendera	Deskripsi
WMDRM_DEVICE_NEEDCLOCK	Memperoleh jam dari server jam yang aman.
WMDRM_DEVICE_REFRESHCLOCK	Refresh jam dari server jam yang aman.

pdwStatus [out]

Salah satu nilai DWORD berikut yang menentukan status yang dikembalikan oleh perangkat.

Status	Deskripsi
0	Tindakan ini tidak didukung.
1	Jam aman perangkat tidak dapat diperoleh dari layanan.
2	Jam aman perangkat tidak dapat disetel.
3	Jam aman perangkat telah diatur.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
DRM_E_INVALIDARG	Satu atau beberapa argumen tidak valid.
NS_E_DEVICE_NOT_WMDRM_DEVICE	Perangkat yang ditentukan bukan perangkat yang kompatibel dengan Windows Media DRM.
NS_E_DRM_UNABLE_TO_GET_SECURE_CLOCK	Gagal mengambil tantangan jam aman dari perangkat atau tidak dapat mengambil URL jam aman dari tantangan.
NS_E_DRM_UNABLE_TO_GET_SECURE_CLOCK_FROM_SERVER	Gagal mengambil respons jam aman dari server jam aman.
NS_E_DRM_UNABLE_TO_SET_SECURE_CLOCK	Gagal mengirim tantangan jam aman ke perangkat, atau perangkat gagal mengatur jam.

Keterangan

Ini adalah metode asinkron; perangkat harus menunggu panggilan balik IWMDMProgress::End untuk operasi ini sebelum mencoba memutar konten berlisensi apa pun.

Aplikasi dapat mempelajari apakah perangkat harus mengatur ulang jamnya atau diperbarui dengan memanggil IWMDRMDeviceApp::QueryDeviceStatus atau IWMDRMDeviceApp2::QueryDeviceStatus2.

Aplikasi Anda harus memiliki koneksi Internet untuk memungkinkannya memperoleh atau mengatur ulang jam yang aman.

Persyaratan

Persyaratan	Nilai
Header	WMDRMDeviceApp.h (juga memerlukan Wmdrmdeviceapp_i.c, dibangun dari WMDRMDeviceApp.idl)
Pustaka	Mssachlp.lib

Lihat juga

Menangani Konten yang Dilindungi dalam Aplikasi
Antarmuka IWMDMDevice
Antarmuka IWMDMProgress3
Antarmuka IWMDRMDeviceApp

Bagikan melalui