Fungsi BCryptSetContextFunctionProperty (bcrypt.h)

Artikel
03/14/2023

Fungsi BCryptSetContextFunctionProperty menetapkan nilai properti bernama untuk fungsi kriptografi dalam konteks CNG yang ada.

Sintaks

NTSTATUS BCryptSetContextFunctionProperty(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] LPCWSTR pszProperty,
  [in] ULONG   cbValue,
  [in] PUCHAR  pbValue
);

Parameter

[in] dwTable

Mengidentifikasi tabel konfigurasi tempat konteks ada. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CRYPT_LOCAL	Konteks ada dalam tabel konfigurasi komputer lokal.
CRYPT_DOMAIN	Nilai ini tidak tersedia untuk digunakan.

[in] pszContext

Penunjuk ke string Unicode yang dihentikan null yang berisi pengidentifikasi konteks untuk mengatur properti fungsi.

[in] dwInterface

Mengidentifikasi antarmuka kriptografi tempat fungsi berada. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE	Fungsi ini ada dalam daftar fungsi enkripsi asimetris.
BCRYPT_CIPHER_INTERFACE	Fungsi ada dalam daftar fungsi cipher.
BCRYPT_HASH_INTERFACE	Fungsi ada dalam daftar fungsi hash.
BCRYPT_RNG_INTERFACE	Fungsi ini ada dalam daftar fungsi generator angka acak.
BCRYPT_SECRET_AGREEMENT_INTERFACE	Fungsi ini ada dalam daftar fungsi perjanjian rahasia.
BCRYPT_SIGNATURE_INTERFACE	Fungsi ada dalam daftar fungsi tanda tangan.
NCRYPT_KEY_STORAGE_INTERFACE	Fungsi ini ada dalam daftar fungsi penyimpanan kunci.
NCRYPT_SCHANNEL_INTERFACE	Fungsi ini ada dalam daftar fungsi Schannel.

[in] pszFunction

Penunjuk ke string Unicode yang dihentikan null yang berisi pengidentifikasi fungsi kriptografi untuk mengatur properti.

[in] pszProperty

Penunjuk ke string Unicode yang dihentikan null yang berisi pengidentifikasi properti yang akan diatur.

[in] cbValue

Berisi ukuran, dalam byte, dari buffer pbValue . Ini adalah jumlah byte yang tepat yang akan disimpan. Jika nilai properti adalah string, Anda harus menambahkan ukuran satu karakter untuk juga menyimpan karakter null yang mengakhiri, jika diperlukan.

[in] pbValue

Alamat buffer yang berisi nilai properti baru.

Nilai kembali

Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.

Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki akses tulis ke properti untuk fungsi tersebut.
STATUS_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.
STATUS_NO_MEMORY	Terjadi kegagalan alokasi memori.
STATUS_NOT_FOUND	Konteks atau fungsi yang ditentukan tidak dapat ditemukan.

Keterangan

BCryptSetContextFunctionProperty hanya dapat dipanggil dalam mode pengguna.

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	bcrypt.h
Pustaka	Bcrypt.lib
DLL	Bcrypt.dll

Bagikan melalui