Metode ICspInformation::GetDefaultSecurityDescriptor (certenroll.h)

Artikel
03/14/2023

Metode GetDefaultSecurityDescriptor mengambil deskriptor keamanan kunci privat default.

Sintaks

HRESULT GetDefaultSecurityDescriptor(
  [in]  VARIANT_BOOL MachineContext,
  [out] BSTR         *pValue
);

Parameter

[in] MachineContext

Variabel VARIANT_BOOL yang menunjukkan apakah akan mengambil pendeskripsi keamanan untuk komputer atau pengguna. Tentukan VARIANT_TRUE untuk komputer dan VARIANT_FALSE untuk pengguna.

[out] pValue

Penunjuk ke variabel BSTR yang berisi deskriptor keamanan.

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 tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Mengembalikan kode/nilai	Deskripsi
CERTSRV_E_PROPERTY_EMPTY	Nilai properti tidak dapat ditemukan.
NTE_BAD_TYPE	Penyedia kriptografi tidak mendukung deskriptor keamanan.
NTE_NOT_FOUND	Penyedia kriptografi tidak mendukung deskriptor keamanan.
NTE_BAD_KEY_STATE	Penyedia kriptografi tidak mendukung deskriptor keamanan.

Keterangan

Untuk menggunakan deskriptor keamanan, Anda harus memanggil fungsi ConvertStringSecurityDescriptorToSecurityDescriptor yang disertakan dengan MICROSOFT Authorization API dan menentukan string yang dikembalikan oleh metode GetDefaultSecurityDescriptor . Fungsi mengembalikan penunjuk ke struktur SECURITY_DESCRIPTOR .

Pendeskripsi keamanan default digunakan untuk menentukan akses ke kunci privat untuk komputer dan pengguna dengan cara berikut:

Secara default, hanya administrator dan layanan lokal yang berjalan di bawah akun LocalSystem yang dapat mengakses kunci privat yang terkait dengan akun komputer.
Saat penyedia menyimpan kunci privat pengguna dalam file terenkripsi di profil pengguna, penyedia menggunakan pendeskripsi keamanan untuk mengatur izin akses ke file.

Metode ini mengambil deskriptor keamanan default yang akan dikaitkan dengan parameter MachineContext yang ditentukan dan penyedia saat ini jika kunci privat baru dibuat. Anda dapat menggunakan pendeskripsi default untuk membuat deskriptor kustom. Deskriptor kustom biasanya dibuat ketika kunci privat yang terkait dengan sertifikat konteks komputer harus digunakan oleh layanan yang berjalan di bawah akun selain akun LocalSystem.

Beberapa penyedia kriptografi tidak mendukung deskriptor keamanan. Contohnya termasuk penyedia kartu pintar dan modul keamanan perangkat keras (HSM).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	certenroll.h
DLL	CertEnroll.dll

Lihat juga

ICspInformation

Bagikan melalui