Fungsi DRMInitEnvironment (msdrm.h)

  • Artikel

[AD RMS SDK yang memanfaatkan fungsionalitas yang diekspos oleh klien di Msdrm.dll tersedia untuk digunakan di Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012, dan Windows 8. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan SDK Layanan Manajemen Hak Direktori Aktif 2.1, yang memanfaatkan fungsionalitas yang diekspos oleh klien dalam Msipc.dll.]

Fungsi DRMInitEnvironment menciptakan lingkungan yang aman untuk semua panggilan manajemen hak.

Sintaks

DRMEXPORT HRESULT UDAPICALL DRMInitEnvironment(
  [in]  DRMSECURITYPROVIDERTYPE eSecurityProviderType,
  [in]  DRMSPECTYPE             eSpecification,
  [in]  PWSTR                   wszSecurityProvider,
  [in]  PWSTR                   wszManifestCredentials,
  [in]  PWSTR                   wszMachineCredentials,
  [out] DRMENVHANDLE            *phEnv,
  [out] DRMHANDLE               *phDefaultLibrary
);

Parameter

[in] eSecurityProviderType

Menentukan jenis penyedia keamanan yang akan digunakan.

[in] eSpecification

Menentukan penyedia keamanan mana yang akan digunakan.

[in] wszSecurityProvider

Nama file dan ID penyedia keamanan. Penyedia keamanan dapat berupa file di komputer (kotak kunci) atau perangkat keras yang menyimpan kunci komputer yang aman. Jalur ke kunci ini diperoleh dengan memanggil DRMGetSecurityProvider.

[in] wszManifestCredentials

Struktur XrML yang ditandatangani yang menentukan kondisi pada lingkungan. Untuk informasi tentang membuat manifes, lihat Membuat Manifes Aplikasi.

[in] wszMachineCredentials

Sertifikat mesin.

[out] phEnv

Penunjuk ke handel lingkungan. Tutup handel dengan memanggil DRMCloseEnvironmentHandle.

[out] phDefaultLibrary

Penunjuk ke handel pustaka yang digunakan untuk membuat objek utama. Anda harus menutup handel ini sebelum menutup handel lingkungan. Untuk informasi lebih lanjut, lihat bagian Keterangan. Tutup dengan memanggil DRMCloseHandle.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam daftar berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Fungsi ini memuat lockbox, dan memastikan bahwa hanya DLL legal yang dimuat, sesuai dengan manifes.

Urutan sertifikat dari yang paling tidak tepercaya terlebih dahulu ke yang paling tepercaya (paling dekat dengan akar) terakhir.

Saat menutup handel yang dikembalikan oleh fungsi ini, tutup handel pustaka sebelum menutup handel lingkungan. Jika tidak, Anda akan menerima kesalahan E_DRM_ENV_NOT_LOADED . Tutup handel pustaka dengan memanggil DRMCloseHandle. Tutup handel lingkungan dengan memanggil DRMCloseEnvironmentHandle.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header msdrm.h
Pustaka Msdrm.lib
DLL Msdrm.dll

Lihat juga

Fungsi AD RMS