Fungsi DRMGetSecurityProvider (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 DRMGetSecurityProvider mengambil jalur ke kotak kunci.

Sintaks

DRMEXPORT HRESULT UDAPICALL DRMGetSecurityProvider(
  [in]      UINT  uFlags,
  [in, out] UINT  *puTypeLen,
  [out]     PWSTR wszType,
  [in, out] UINT  *puPathLen,
  [out]     PWSTR wszPath
);

Parameter

[in] uFlags

Dicadangkan.

[in, out] puTypeLen

Pada input, panjang buffer wszType yang dialokasikan. Pada output, panjang aktual, dalam karakter, ditambah satu untuk terminator null, dari nilai yang dikembalikan oleh wszType.

[out] wszType

Jenis penyedia keamanan (seperti "nama file").

[in, out] puPathLen

Pada input, panjang buffer wszPath yang dialokasikan. Pada output, panjang aktual, dalam karakter, ditambah satu untuk terminator null, dari nilai yang dikembalikan oleh wszPath.

[out] wszPath

Jalur ke kotak kunci.

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

Ketika Anda mendapatkan nilai output, pertama-tama panggil fungsi ini dengan wszType dan wszPath diatur ke NULL untuk mendapatkan ukuran buffer yang diperlukan melalui puTypeLen dan puPathLen. Jika Anda hanya mengatur satu penunjuk buffer ke NULL, kesalahan akan dihasilkan. Aplikasi bertanggung jawab untuk mengalokasikan dan membebaskan ruang buffer.

Persyaratan

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

Lihat juga

Fungsi AD RMS