Fungsi DRMCloseHandle (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 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 DRMCloseHandle menutup handel ke objek yang dibuat dengan fungsi dan pustaka DRMCreate* yang dimuat dengan menggunakan DRMLoadLibrary.

Sintaks

DRMEXPORT HRESULT UDAPICALL DRMCloseHandle(
  [in] DRMHANDLE handle
);

Parameter

[in] handle

Handel untuk ditutup.

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Fungsi ini menghapus data sensitif dengan benar dari memori dan memungkinkan sistem AD RMS untuk menjaga jumlah referensi yang akurat pada objek yang digunakan. Jika objek berisi objek terbuka lainnya di dalamnya, memanggil fungsi ini akan memaksa semua objek yang terkandung untuk ditutup juga. Namun, memaksa penutupan objek yang terkandung dengan cara ini tidak disarankan.

Jika fungsi ini gagal, aplikasi harus menghancurkan proses saat ini setelah menutup lingkungan dengan DRMCloseEnvironmentHandle.

Menutup handel ke pustaka akan menyebabkan pustaka dibongkar jika tidak memiliki objek terbuka yang tersisa.

Persyaratan

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

Lihat juga

Fungsi AD RMS

Penanganan dan Sesi AD RMS