Fungsi DRMLoadLibrary (msdrm.h)

  • Artikel
  • 2 menit untuk membaca

[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 dapat diubah atau

tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan Active Directory Rights Management Services SDK 2.1,

yang memanfaatkan fungsionalitas yang diekspos oleh klien dalam Msipc.dll.]

Fungsi DRMLoadLibrary memuat handel ke pustaka yang disetujui, seperti yang ditentukan oleh kredensial.

Sintaks

DRMEXPORT HRESULT UDAPICALL DRMLoadLibrary(
  [in]  DRMENVHANDLE hEnv,
  [in]  DRMSPECTYPE  eSpecification,
  [in]  PWSTR        wszLibraryProvider,
  [in]  PWSTR        wszCredentials,
  [out] DRMHANDLE    *phLibrary
);

Parameter

[in] hEnv

Handel ke lingkungan, dibuat oleh DRMInitEnvironment.

[in] eSpecification

Jenis penyedia pustaka.

[in] wszLibraryProvider

Nama dan jalur opsional ke DLL. Setiap DLL harus memiliki nama yang unik. Jika DLL bernama serupa dimuat, bahkan jika berada di jalur yang berbeda, hanya item pertama yang akan disertakan dalam manifes dan diperiksa.

[in] wszCredentials

Dicadangkan, harus NULL. DLL yang dimuat harus direferensikan dalam manifes aplikasi yang dimuat oleh DRMInitEnvironment.

[out] phLibrary

Handel ke pustaka.

Mengembalikan nilai

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 adalah versi aman dari fungsi LoadLibrary , namun tidak mendukung opsi tambahan LoadLibraryEx. Handel yang dikembalikan sesuai dengan output HMODULE oleh LoadLibrary. Untuk menutup handel yang dikembalikan, panggil DRMCloseHandle, bukan FreeLibrary. Secara default, direktori saat ini adalah satu-satunya lokasi yang dicari fungsi ini untuk pustaka. Direktori lain harus ditentukan oleh jalur lengkap, atau jalur yang relatif terhadap direktori saat ini. Gunakan DRMGetProcAddress, versi aman fungsi GetProcAddress , untuk mendapatkan alamat fungsi di pustaka yang dimuat.

Dependensi DLL yang dimuat juga akan dimuat, asalkan disertakan dalam kredensial plug-in dan ditandatangani dengan benar. Jika DLL telah dimuat, fungsi akan mengembalikan S_OK dan mengembalikan penunjuk ke handel yang sama.

Catatan Jika aplikasi mencoba memuat pustaka kedua dengan nama pustaka yang dimuat sebelumnya, pustaka baru ini tidak akan diperiksa terhadap manifes, meskipun berasal dari jalur yang berbeda. Gunakan hanya pustaka bernama unik untuk menghindari pengecekan manifes ini.

 

Persyaratan

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

Lihat juga

Fungsi AD RMS

DRMGetProcAddress