Fungsi CryptExportPublicKeyInfoFromBCryptKeyHandle (wincrypt.h)

  • Artikel

Fungsi CryptExportPublicKeyInfoFromBCryptKeyHandle mengekspor informasi kunci publik yang terkait dengan kunci privat penyedia yang sesuai.

Sintaks

BOOL CryptExportPublicKeyInfoFromBCryptKeyHandle(
  [in]            BCRYPT_KEY_HANDLE     hBCryptKey,
  [in]            DWORD                 dwCertEncodingType,
  [in, optional]  LPSTR                 pszPublicKeyObjId,
  [in]            DWORD                 dwFlags,
  [in, optional]  void                  *pvAuxInfo,
  [out, optional] PCERT_PUBLIC_KEY_INFO pInfo,
  [in, out]       DWORD                 *pcbInfo
);

Parameter

[in] hBCryptKey

Handel kunci untuk mengekspor informasi kunci publik.

[in] dwCertEncodingType

Menentukan jenis pengodean yang akan dicocokkan.

Nilai ini bisa menjadi kombinasi bitwise dari jenis pengodean yang saat ini ditentukan:

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in, optional] pszPublicKeyObjId

Penunjuk ke pengidentifikasi objek (OID) yang mengidentifikasi fungsi yang dapat diinstal untuk digunakan untuk mengekspor kunci. Jika kata urutan tinggi OID bukan nol, pszPublicKeyObjId adalah penunjuk ke string OID seperti "2.5.29.1" atau string ASCII seperti "file." Jika kata urutan tinggi OID adalah nol, kata berurutan rendah menentukan pengidentifikasi bilangan bulat yang akan digunakan sebagai pengidentifikasi objek.

[in] dwFlags

Nilai DWORD yang menunjukkan bagaimana informasi kunci publik diekspor.

Nilai Makna
CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
0x80000000
 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
0x40000000
 Melompati kunci publik dalam grup CRYPT_PUBKEY_ALG_OID_GROUP_ID yang secara eksplisit ditandai dengan bendera CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG .

[in, optional] pvAuxInfo

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

[out, optional] pInfo

Penunjuk ke struktur CERT_PUBLIC_KEY_INFO untuk menerima informasi kunci publik yang akan diekspor.

Parameter ini bisa NULL untuk mengatur ukuran informasi ini untuk tujuan alokasi memori. Untuk informasi selengkapnya, lihat Mengambil Data Dengan Panjang Tidak Diketahui.

[in, out] pcbInfo

Penunjuk ke DWORD yang berisi ukuran, dalam byte, dari buffer yang diacu oleh parameter pInfo . Saat fungsi kembali, DWORD berisi jumlah byte yang disimpan dalam buffer.

Nilai kembali

Fungsi mengembalikan TRUE jika berhasil; jika tidak, ia mengembalikan FALSE.

Keterangan

Jika fungsi CryptExportPublicKeyInfoFromBCryptKeyHandle tidak dapat menemukan fungsi OID yang dapat diinstal untuk OID yang ditentukan oleh parameter pszPublicKeyObjId , fungsi ini mencoba mengekspor kunci sebagai Kunci Umum RSA (szOID_RSA_RSA). Jika kunci diekspor sebagai Kunci Umum RSA, nilai parameter dwFlags dan pvAuxInfo tidak digunakan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header wincrypt.h
Pustaka Crypt32.lib
DLL Crypt32.dll