Fungsi NCryptSetProperty (ncrypt.h)
Fungsi NCryptSetProperty menetapkan nilai untuk properti bernama untuk objek penyimpanan kunci CNG.
Sintaks
SECURITY_STATUS NCryptSetProperty(
[in] NCRYPT_HANDLE hObject,
[in] LPCWSTR pszProperty,
[in] PBYTE pbInput,
[in] DWORD cbInput,
[in] DWORD dwFlags
);
Parameter
[in] hObject
Handel objek penyimpanan kunci untuk mengatur properti .
[in] pszProperty
Penunjuk ke string Unicode yang dihentikan null yang berisi nama properti yang akan diatur. Ini bisa menjadi salah satu Pengidentifikasi Properti Penyimpanan Kunci yang telah ditentukan sebelumnya atau pengidentifikasi properti kustom.
[in] pbInput
Alamat buffer yang berisi nilai properti baru. Parameter cbInput berisi ukuran buffer ini.
[in] cbInput
Ukuran, dalam byte, dari buffer pbInput .
[in] dwFlags
Bendera yang mengubah perilaku fungsi. Ini bisa menjadi nol atau kombinasi dari satu atau beberapa nilai berikut.
Untuk properti NCRYPT_SECURITY_DESCR_PROPERTY , parameter ini juga harus berisi salah satu nilai berikut, yang mengidentifikasi bagian dari deskriptor keamanan yang akan diatur.
Nilai | Makna |
---|---|
|
Atur pengidentifikasi keamanan (SID) pemilik objek. Gunakan fungsi SetSecurityDescriptorOwner untuk mengatur SID pemilik dalam struktur SECURITY_DESCRIPTOR . |
|
Atur SID grup utama objek. Gunakan fungsi SetSecurityDescriptorGroup untuk mengatur SID grup dalam struktur SECURITY_DESCRIPTOR . |
|
Atur daftar kontrol akses diskresi (DACL). Gunakan fungsi SetSecurityDescriptorDacl untuk mengatur DACL dalam struktur SECURITY_DESCRIPTOR . |
|
Atur daftar kontrol akses sistem (SACL). Gunakan fungsi SetSecurityDescriptorSacl untuk mengatur SACL dalam struktur SECURITY_DESCRIPTOR . |
|
Atur entri kontrol akses label wajib di SACL objek. Gunakan fungsi SetSecurityDescriptorSacl untuk mengatur SACL dalam struktur SECURITY_DESCRIPTOR . Untuk informasi selengkapnya tentang entri kontrol akses label wajib, lihat Desain Mekanisme Integritas Windows. |
Mengembalikan nilai
Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.
Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Fungsi berhasil. |
|
Parameter dwFlags berisi nilai yang tidak valid. |
|
Parameter hObject tidak valid. |
|
Satu atau beberapa parameter tidak valid. |
|
Terjadi kegagalan alokasi memori. |
|
Properti yang ditentukan tidak didukung untuk objek. |
Keterangan
Layanan tidak boleh memanggil fungsi ini dari Fungsi StartService-nya. Jika layanan memanggil fungsi ini dari fungsi StartService-nya, kebuntuan dapat terjadi, dan layanan mungkin berhenti merespons.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | ncrypt.h |
Pustaka | Ncrypt.lib |
DLL | Ncrypt.dll |