Fungsi BCryptQueryContextConfiguration (bcrypt.h)

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

Fungsi BCryptQueryContextConfiguration mengambil konfigurasi saat ini untuk konteks CNG yang ditentukan.

Sintaks

NTSTATUS BCryptQueryContextConfiguration(
  [in]      ULONG                 dwTable,
  [in]      LPCWSTR               pszContext,
  [in, out] ULONG                 *pcbBuffer,
  [in, out] PCRYPT_CONTEXT_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.

[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 pointer ke struktur CRYPT_CONTEXT_CONFIG yang menerima informasi konfigurasi konteks 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 yang ditentukan tidak dapat ditemukan.

Keterangan

Setiap konteks 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 configuration information for the context.
CRYPT_CONTEXT_CONFIG config;
ULONG uSize = sizeof(config);
PCRYPT_CONTEXT_CONFIG pConfig = &config;
status = BCryptQueryContextConfiguration(
    CRYPT_LOCAL, 
    pszContextID, 
    &uSize, 
    &pConfig);

BCryptQueryContextConfiguration 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