Metode IWMDRMLicenseQuery::QueryLicenseState

Artikel
06/21/2023

[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 QueryLicenseState meminta penyimpanan lisensi lokal untuk informasi lisensi yang berlaku untuk ID Kunci untuk satu atau beberapa hak tertentu.

Sintaks

HRESULT QueryLicenseState(
  [in]  BSTR                   bstrKID,
  [in]  DWORD                  cActionsToQuery,
  [in]  BSTR                   rgbstrActionsToQuery[],
  [out] DRM_LICENSE_STATE_DATA rgResultStateData[]
);

Parameter

bstrKID [in]

ID Kunci yang akan dikueri. Hanya lisensi yang berlaku untuk ID Kunci ini yang akan dievaluasi.

cActionsToQuery [in]

Jumlah tindakan yang akan dikueri. Nilai ini harus diatur ke jumlah elemen dalam array yang diteruskan untuk parameter rgbstrActionsToQuery dan rgResultStateData .

rgbstrActionsToQuery[] [in]

Array dari satu atau beberapa hak yang akan dikueri. Array ini harus berisi elemen sebanyak yang ditentukan oleh cActionsToQuery. Setiap elemen harus diatur ke salah satu konstanta berikut.

Terus-menerus	Deskripsi
g_wszWMDRM_LicenseState_Backup	Sertakan ke kueri untuk detail tentang hak untuk mencadangkan dan memulihkan lisensi.
g_wszWMDRM_LicenseState_CollaborativePlay	Sertakan ke kueri untuk detail tentang hak berbagi konten dengan sekelompok pengguna sebagai bagian dari skenario pemutaran kolaboratif.
g_wszWMDRM_LicenseState_Copy	Sertakan ke kueri untuk detail tentang hak menyalin konten ke perangkat atau media eksternal.
g_wszWMDRM_LicenseState_CopyToCD	Sertakan ke kueri untuk detail tentang hak untuk menyalin konten ke CD.
g_wszWMDRM_LicenseState_CopyToNonSDMIDevice	Sertakan ke kueri untuk detail tentang hak menyalin konten ke perangkat yang tidak mendukung inisiatif media digital aman (SDMI).
g_wszWMDRM_LicenseState_CopyToSDMIDevice	Sertakan ke kueri untuk detail tentang hak menyalin konten ke perangkat yang mendukung SDMI.
g_wszWMDRM_LicenseState_CreateThumbnailImage	Sertakan ke kueri untuk detail tentang hak untuk membuat gambar mini dari konten.
g_wszWMDRM_LicenseState_Playback	Sertakan ke kueri untuk detail tentang hak untuk memutar konten.
g_wszWMDRM_LicenseState_PlaylistBurn	Sertakan ke kueri untuk detail tentang hak menyalin konten ke CD sebagai bagian dari daftar putar.

rgResultStateData[] [out]

Array dari satu atau beberapa struktur DRM_LICENSE_STATE_DATA yang menerima informasi status lisensi yang berlaku di sebelah kanan dalam elemen yang sesuai dari parameter rgbstrActionsToQuery .

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.

Keterangan

Semua lisensi yang berlaku untuk ID Kunci yang ditentukan akan dicari dan dievaluasi. Hasilnya dikumpulkan, sehingga setiap struktur DRM_LICENSE_STATE_DATA mungkin berisi informasi dari beberapa lisensi.

Persyaratan

Persyaratan	Nilai
Header	Wmdrmsdk.h
Pustaka	Wmdrmsdk.lib

Lihat juga

Antarmuka IWMDRMLicenseQuery

Bagikan melalui