Bagikan melalui


Memperbarui Lisensi

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

Toko online dapat mengirimkan konten yang dilisensikan untuk jangka waktu tertentu atau hingga tanggal tertentu. Ini akan normal untuk konten musik yang dikirimkan sebagai bagian dari perjanjian layanan langganan. Dalam hal ini, toko online membutuhkan kesempatan untuk memperbarui lisensi ini sebelum kedaluwarsa, dengan asumsi, tentu saja, bahwa pengguna telah membayar untuk memperbarui langganannya. (Jika pengguna belum memperbarui langganan, lisensi hanya dapat dibiarkan kedaluwarsa.)

Pemutar Media Windows mengkueri plug-in mitra konten tentang berapa banyak peringatan sebelumnya yang harus diberikan Pemutar tentang lisensi yang akan kedaluwarsa. Ini dilakukan dengan memanggil IWMPContentPartner::GetContentPartnerInfo, melewati konstanta g_szContentPartnerInfo_LicenseRefreshAdvanceWarning melalui parameter bstrInfoName . Untuk memperingatkan plug-in tentang lisensi yang akan kedaluwarsa, Pemutar Media Windows memanggil IWMPContentPartner::RefreshLicense. Panggilan ini mengambil parameter yang memberikan detail tentang file yang sedang disegarkan, seperti apakah file berada di komputer pengguna, dan jalur ke file. Jika lisensi sedang disegarkan sebagai bagian dari operasi sinkronisasi perangkat, parameter pReasonContext memasok nama meriam perangkat

Saat Pemutar Media Windows memanggil RefreshLicence, ia meneruskan cookie yang mengidentifikasi permintaan pembaruan. Ketika plug-in telah selesai memproses permintaan pembaruan, plug-in memberi tahu Pemutar Media Windows dengan memanggil IWMPContentPartnerCallback::RefreshLicenseComplete, meneruskan cookie, ID item media, dan HRESULT yang menunjukkan apakah pembaruan berhasil.

Plug-in toko online juga dapat melakukan inspeksi lisensi dan pembaruan sebagai proses latar belakang. Pemutar Media Windows memberi tahu plug-in tentang waktu ketika diizinkan untuk melakukan tugas pemrosesan latar belakang dengan memanggil IWMPContentPartner::Notify. Untuk memberi sinyal plug-in untuk memulai pemrosesan latar belakang, Pemutar melewati nilai enumerasi WMPPartnerNotification wmpsnBackgroundProcessingBegin; untuk memberi sinyal plug-in untuk menghentikan pemrosesan latar belakang, Pemutar meneruskan nilai wmpsnBackgroundProcessingEnd.

Panduan Pemrograman untuk Toko Online Tipe 1