Fungsi BCryptAddContextFunction (bcrypt.h)

[BCryptAddContextFunction tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Fungsi BCryptAddContextFunction menambahkan fungsi kriptografi ke daftar fungsi yang didukung oleh konteks CNG yang ada.

Sintaks

NTSTATUS BCryptAddContextFunction(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] ULONG   dwPosition
);

Parameter

[in] dwTable

Mengidentifikasi tabel konfigurasi tempat konteks berada. 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 menambahkan fungsi.

[in] dwInterface

Mengidentifikasi antarmuka kriptografi untuk menambahkan fungsi. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE	Tambahkan fungsi ke daftar fungsi enkripsi asimetris.
BCRYPT_CIPHER_INTERFACE	Tambahkan fungsi ke daftar fungsi cipher.
BCRYPT_HASH_INTERFACE	Tambahkan fungsi ke daftar fungsi hash.
BCRYPT_RNG_INTERFACE	Tambahkan fungsi ke daftar fungsi generator angka acak.
BCRYPT_SECRET_AGREEMENT_INTERFACE	Tambahkan fungsi ke daftar fungsi perjanjian rahasia.
BCRYPT_SIGNATURE_INTERFACE	Tambahkan fungsi ke daftar fungsi tanda tangan.
NCRYPT_KEY_STORAGE_INTERFACE	Tambahkan fungsi ke daftar fungsi penyimpanan kunci.
NCRYPT_SCHANNEL_INTERFACE	Tambahkan fungsi ke daftar fungsi Schannel.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE	Tambahkan fungsi ke daftar suite tanda tangan yang akan diterima Schannel untuk TLS 1.2. Windows Vista dan Windows Server 2008: Nilai ini tidak didukung.

[in] pszFunction

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

[in] dwPosition

Menentukan posisi dalam daftar untuk menyisipkan fungsi ini. Fungsi ini disisipkan pada posisi ini di depan fungsi yang ada. Nilai CRYPT_PRIORITY_TOP digunakan untuk menyisipkan fungsi di bagian atas daftar. Nilai CRYPT_PRIORITY_BOTTOM digunakan untuk menyisipkan fungsi di akhir daftar.

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_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.
STATUS_NO_MEMORY	Terjadi kegagalan alokasi memori.
STATUS_NOT_FOUND	Konteks tidak dapat ditemukan.

Keterangan

Jika fungsi yang ditambahkan sudah ada dalam daftar, fungsi akan dihapus dan disisipkan pada posisi baru.

BCryptAddContextFunction 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

Lihat juga

BCryptRemoveContextFunction