Fungsi BCryptAddContextFunction (bcrypt.h)

  • Artikel

[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