Fungsi CryptImportPublicKeyInfoEx2 (wincrypt.h)

Artikel
08/27/2023

Fungsi CryptImportPublicKeyInfoEx2 mengimpor kunci publik ke penyedia asimetris CNG yang sesuai dengan pengidentifikasi objek kunci publik (OID) dan mengembalikan handel CNG ke kunci.

Sintaks

BOOL CryptImportPublicKeyInfoEx2(
  [in]  DWORD                 dwCertEncodingType,
  [in]  PCERT_PUBLIC_KEY_INFO pInfo,
  [in]  DWORD                 dwFlags,
  [in]  void                  *pvAuxInfo,
  [out] BCRYPT_KEY_HANDLE     *phKey
);

Parameter

[in] dwCertEncodingType

Jenis pengodean sertifikat yang digunakan untuk mengenkripsi subjek. Pengidentifikasi jenis pengodean pesan, yang terkandung dalam WORD tinggi dari nilai ini, diabaikan oleh fungsi ini.

Parameter ini dapat menjadi jenis pengodean sertifikat yang saat ini ditentukan berikut.

Nilai	Makna
X509_ASN_ENCODING 1 (0x1)	Menentukan pengodean sertifikat X.509 .

[in] pInfo

Alamat struktur CERT_PUBLIC_KEY_INFO yang berisi informasi kunci publik untuk diimpor ke penyedia.

[in] dwFlags

Sekumpulan bendera yang mengubah perilaku fungsi ini. Ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut.

Nilai	Makna
CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG	Melompati kunci publik dalam grup CRYPT_PUBKEY_ALG_OID_GROUP_ID yang secara eksplisit ditandai dengan bendera CRYPT_OID_PUBKEY_ENCRYPT_ONLY_FLAG.
CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG	Melompati kunci publik dalam grup CRYPT_PUBKEY_ALG_OID_GROUP_ID yang secara eksplisit ditandai dengan bendera CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG.

Bendera ini diteruskan dalam parameter dwKeyType dari fungsi CryptFindOIDInfo saat memetakan pengidentifikasi objek kunci publik ke pengidentifikasi algoritma kunci publik CNG yang sesuai.

[in] pvAuxInfo

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke NULL.

[out] phKey

Alamat variabel BCRYPT_KEY_HANDLE yang menerima handel kunci yang diimpor.

Ketika handel ini tidak lagi diperlukan, Anda harus merilisnya dengan memanggil fungsi BCryptDestroyKey .

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan bukan nol (TRUE).

Jika fungsi gagal, fungsi akan mengembalikan nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Kemungkinan kode kesalahan termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode	Deskripsi
ERROR_FILE_NOT_FOUND	Fungsi impor yang dapat diinstal atau didaftarkan tidak dapat ditemukan untuk parameter dwCertEncodingType dan pInfo yang ditentukan.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.

Persyaratan


Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Crypt32.lib
DLL	Crypt32.dll

Lihat juga

CERT_PUBLIC_KEY_INFO