Fungsi BCryptQueryContextFunctionConfiguration (bcrypt.h)

Artikel
03/14/2023

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

Fungsi BCryptQueryContextFunctionConfiguration mendapatkan informasi konfigurasi fungsi kriptografi untuk konteks CNG yang ada.

Sintaks

NTSTATUS BCryptQueryContextFunctionConfiguration(
  [in]      ULONG                          dwTable,
  [in]      LPCWSTR                        pszContext,
  [in]      ULONG                          dwInterface,
  [in]      LPCWSTR                        pszFunction,
  [in, out] ULONG                          *pcbBuffer,
  [in, out] PCRYPT_CONTEXT_FUNCTION_CONFIG *ppBuffer
);

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 mendapatkan informasi konfigurasi fungsi.

[in] dwInterface

Mengidentifikasi antarmuka kriptografi untuk mendapatkan informasi konfigurasi fungsi. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE	Dapatkan informasi konfigurasi fungsi dari daftar fungsi enkripsi asimetris.
BCRYPT_CIPHER_INTERFACE	Dapatkan informasi konfigurasi fungsi dari daftar fungsi cipher.
BCRYPT_HASH_INTERFACE	Dapatkan informasi konfigurasi fungsi dari daftar fungsi hash.
BCRYPT_RNG_INTERFACE	Dapatkan informasi konfigurasi fungsi dari daftar fungsi generator angka acak.
BCRYPT_SECRET_AGREEMENT_INTERFACE	Dapatkan informasi konfigurasi fungsi dari daftar fungsi perjanjian rahasia.
BCRYPT_SIGNATURE_INTERFACE	Dapatkan informasi konfigurasi fungsi dari daftar fungsi tanda tangan.
NCRYPT_KEY_STORAGE_INTERFACE	Dapatkan informasi konfigurasi fungsi dari daftar fungsi penyimpanan utama.
NCRYPT_SCHANNEL_INTERFACE	Dapatkan informasi konfigurasi fungsi dari daftar fungsi Schannel.

[in] pszFunction

Penunjuk ke string Unicode yang dihentikan null yang berisi pengidentifikasi fungsi kriptografi untuk mendapatkan informasi konfigurasi.

[in, out] pcbBuffer

Alamat variabel ULONG yang, pada entri, berisi ukuran, dalam byte, dari buffer yang diacu oleh ppBuffer. Jika ukuran ini tidak cukup besar untuk menyimpan informasi konteks, fungsi ini akan gagal dengan STATUS_BUFFER_TOO_SMALL.

Setelah fungsi ini kembali, variabel ini berisi jumlah byte yang disalin ke buffer ppBuffer .

[in, out] ppBuffer

Alamat penunjuk ke struktur CRYPT_CONTEXT_FUNCTION_CONFIG yang menerima informasi konfigurasi fungsi yang diambil oleh fungsi ini. Nilai yang ditujukkan oleh parameter pcbBuffer berisi ukuran buffer ini.

Jika nilai yang ditunjukkan oleh parameter ini adalah NULL, fungsi ini akan mengalokasikan memori yang diperlukan. Memori ini harus dikosongkan ketika tidak lagi diperlukan dengan meneruskan pointer ini ke fungsi BCryptFreeBuffer .

Jika parameter ini NULL, fungsi ini akan menempatkan ukuran yang diperlukan, dalam byte, dalam variabel yang ditunjukkan oleh parameter pcbBuffer dan mengembalikan STATUS_BUFFER_TOO_SMALL.

Untuk informasi selengkapnya tentang penggunaan parameter ini, lihat Keterangan.

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_BUFFER_TOO_SMALL	Parameter ppBuffer tidak NULL, dan nilai yang ditunjukkan oleh parameter pcbBuffer tidak cukup besar untuk menahan set konteks.
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

Setiap fungsi kriptografi hanya memiliki satu set informasi konfigurasi, jadi meskipun parameter ppBuffer tampaknya digunakan sebagai array, fungsi ini memperlakukan ini sebagai array hanya dengan satu elemen. Contoh berikut membantu mengklarifikasi bagaimana parameter ini digunakan.

// Get the function configuration information.
CRYPT_CONTEXT_FUNCTION_CONFIG FuncConfig;
ULONG uSize = sizeof(FuncConfig);
PCRYPT_CONTEXT_FUNCTION_CONFIG pFuncConfig = &FuncConfig;
status = BCryptQueryContextFunctionConfiguration(
    CRYPT_LOCAL, 
    pszContext, 
    NCRYPT_SCHANNEL_INTERFACE,
    pszFunction,
    &uSize, 
    &pFuncConfig);

BCryptQueryContextFunctionConfiguration 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

CRYPT_CONTEXT_FUNCTION_CONFIG

Bagikan melalui