Fungsi BCryptSetProperty (bcrypt.h)
Fungsi BCryptSetProperty menetapkan nilai properti bernama untuk objek CNG.
Sintaks
NTSTATUS BCryptSetProperty(
[in, out] BCRYPT_HANDLE hObject,
[in] LPCWSTR pszProperty,
[in] PUCHAR pbInput,
[in] ULONG cbInput,
[in] ULONG dwFlags
);
Parameter
[in, out] hObject
Handel yang mewakili objek CNG untuk mengatur nilai properti.
[in] pszProperty
Penunjuk ke string Unicode yang dihentikan null yang berisi nama properti yang akan diatur. Ini bisa menjadi salah satu Pengidentifikasi Properti Primitif Kriptografi 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
Sekumpulan bendera yang mengubah perilaku fungsi ini. Tidak ada bendera yang ditentukan untuk fungsi ini.
Nilai kembali
Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.
Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Fungsi berhasil. |
|
Handel dalam parameter hObject tidak valid. |
|
Satu atau beberapa parameter tidak valid. |
|
Properti bernama yang ditentukan oleh parameter pszProperty tidak didukung atau bersifat baca-saja. |
Keterangan
Bergantung pada mode prosesor apa yang didukung penyedia, BCryptSetProperty dapat dipanggil baik dari mode pengguna atau mode kernel. Pemanggil mode kernel dapat mengeksekusi baik di PASSIVE_LEVEL IRQL atau DISPATCH_LEVEL IRQL. Jika tingkat IRQL saat ini DISPATCH_LEVEL, setiap pointer yang diteruskan ke BCryptSetProperty harus merujuk ke memori yang tidak di-patok (atau dikunci). Jika objek yang ditentukan dalam parameter hObject adalah handel, objek tersebut harus dibuka dengan menggunakan bendera BCRYPT_PROV_DISPATCH .
Untuk memanggil fungsi ini dalam mode kernel, gunakan Cng.lib, yang merupakan bagian dari Driver Development Kit (DDK). Windows Server 2008 dan Windows Vista: Untuk memanggil fungsi ini dalam mode kernel, gunakan Ksecdd.lib.
Saat mengatur nilai untuk properti BCRYPT_CHAINING_MODE, parameter pbInput tidak dibatasi oleh cbInput. Pemanggil perlu memastikan string Unicode yang dihentikan null yang valid disediakan.
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 | bcrypt.h |
Pustaka | Bcrypt.lib |
DLL | Bcrypt.dll |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk