Metode IWMDRMSecurity::GetMachineCertificate

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 GetMachineCertificate mengambil sertifikat mesin subsistem DRM pada komputer klien.

Sintaks

HRESULT GetMachineCertificate(
  [in]      DWORD dwCertificateType,
  [out]     BYTE  rgbVersion[4],
  [out]     BYTE  **ppbCertificate,
  [in, out] DWORD *pcbCertificate
);

Parameter

dwCertificateType [in]

Jenis sertifikat yang akan diambil. Atur ke salah satu nilai dalam tabel berikut ini.

Nilai	Deskripsi
WMDRM_CERTIFICATE_TYPE_V1	Sertifikat akan diambil dalam format yang digunakan oleh komponen warisan.
WMDRM_CERTIFICATE_TYPE_V2	Sertifikat akan diambil dalam format yang digunakan oleh komponen Windows Vista.

rgbVersion[4] [out]

Array empat byte yang menentukan versi subsistem DRM pada komputer klien.

ppbCertificate [out]

Alamat variabel yang menerima penunjuk ke data sertifikat. Atur ke NULL agar metode menyediakan ukuran buffer yang diperlukan untuk menahan sertifikat dalam pcbCertificate.

pcbCertificate [masuk, keluar]

Ukuran sertifikat dalam byte. Jika ppbCertificateNULL, nilai ini akan diatur ke ukuran sertifikat. Jika ppbCertificate bukan NULL, nilai ini harus diatur ke ukuran buffer.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Persyaratan

Persyaratan	Nilai
Header	Wmdrmsdk.h
Pustaka	Wmdrmsdk.lib

Lihat juga

Antarmuka Keamanan IWMDRM

Bagikan melalui