Bagikan melalui

Fungsi BCryptQueryContextFunctionProperty (bcrypt.h)

Fungsi BCryptQueryContextFunctionProperty mendapatkan nilai properti bernama untuk fungsi kriptografi dalam konteks CNG yang ada.

Sintaks

NTSTATUS BCryptQueryContextFunctionProperty(
  [in]      ULONG   dwTable,
  [in]      LPCWSTR pszContext,
  [in]      ULONG   dwInterface,
  [in]      LPCWSTR pszFunction,
  [in]      LPCWSTR pszProperty,
  [in, out] ULONG   *pcbValue,
  [in, out] PUCHAR  *ppbValue
);

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 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 mendapatkan properti .

[in] pszProperty

Penunjuk ke string Unicode yang dihentikan null yang berisi pengidentifikasi properti untuk diperoleh.

[in, out] pcbValue

Alamat variabel ULONG yang, pada entri, berisi ukuran, dalam byte, dari buffer yang diacu oleh ppbValue. Jika ukuran ini tidak cukup besar untuk menahan nilai properti, fungsi ini akan gagal dengan STATUS_BUFFER_TOO_SMALL.

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

[in, out] ppbValue

Alamat penunjuk ke buffer yang menerima data properti. Ukuran dan format buffer ini tergantung pada format properti yang diambil. Nilai yang diacu oleh parameter pcbValue 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 pcbValue dan mengembalikan STATUS_BUFFER_TOO_SMALL.

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 ppbValue bukan NULL, dan nilai yang ditunjukkan oleh parameter pcbValue 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, fungsi, atau properti yang ditentukan tidak dapat ditemukan.

Keterangan

BCryptQueryContextFunctionProperty 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
  • Last updated on