Fungsi BCryptSetContextFunctionProperty (bcrypt.h)

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