Fungsi CryptImportPKCS8 (wincrypt.h)

  • Artikel

[Fungsi CryptImportPKCS8 tidak lagi tersedia untuk digunakan pada Windows Server 2008 dan Windows Vista. Sebagai gantinya, gunakan fungsi PFXImportCertStore .]

Penting API ini tidak digunakan lagi. Perangkat lunak baru dan yang sudah ada harus mulai menggunakan Cryptography Next Generation API. Microsoft dapat menghapus API ini dalam rilis mendatang.
 
Fungsi CryptImportPKCS8 mengimpor kunci privat dalam format PKCS #8 ke penyedia layanan kriptografi (CSP). CryptImportPKCS8 akan mengembalikan handel ke penyedia dan impor KeySpec yang digunakan.

Sintaks

BOOL CryptImportPKCS8(
  [in]            CRYPT_PKCS8_IMPORT_PARAMS sPrivateKeyAndParams,
  [in]            DWORD                     dwFlags,
  [out, optional] HCRYPTPROV                *phCryptProv,
  [in, optional]  void                      *pvAuxInfo
);

Parameter

[in] sPrivateKeyAndParams

Struktur CRYPT_PKCS8_IMPORT_PARAMS yang berisi BLOB kunci privat dan parameter yang sesuai.

[in] dwFlags

Nilai DWORD . Parameter ini bisa menjadi salah satu nilai berikut, kombinasinya, atau nilai null.

Nilai Makna
CRYPT_EXPORTABLE
 Kunci yang diimpor akhirnya akan diekspor ulang. Jika bendera ini tidak digunakan, maka panggilan ke CryptExportKey dengan handel kunci gagal.
CRYPT_USER_PROTECTED
 Jika bendera ini diatur, CSP memberi tahu pengguna melalui kotak dialog atau beberapa metode lain ketika tindakan tertentu dicoba menggunakan kunci ini. Perilaku yang tepat ditentukan oleh CSP atau jenis CSP yang digunakan. Jika konteks penyedia diperoleh dengan set CRYPT_SILENT, menggunakan bendera ini menyebabkan kegagalan, dan kesalahan terakhir diatur ke NTE_SILENT_CONTEXT.

[out, optional] phCryptProv

Pointer ke HCRYPTPROV untuk menerima handel penyedia tempat kunci diimpor dengan memanggil fungsi CryptImportPKCS8 .

Setelah Anda selesai menggunakan handel, bebaskan handel dengan memanggil CryptReleaseContext.

Parameter ini bisa NULL, dalam hal ini handel penyedia tidak dikembalikan.

[in, optional] pvAuxInfo

Parameter ini harus NULL.

Nilai kembali

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

Jika fungsi gagal, fungsi mengembalikan nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Kode kesalahan berikut khusus untuk fungsi ini.

Menampilkan kode Deskripsi
ERROR_UNSUPPORTED_TYPE
 Pengidentifikasi objek algoritma (OID) kunci privat tidak didukung.
 

Jika fungsi gagal, GetLastError dapat mengembalikan kesalahan pengodean/pendekodean Abstract Syntax Notation One (ASN.1). Untuk informasi tentang kesalahan ini, lihat Nilai Pengembalian Pengodean/Pendekodean ASN.1.

Keterangan

CryptImportPKCS8 memanggil fungsi PCRYPT_RESOLVE_HCRYPTPROV_FUNC dengan menggunakan struktur CRYPT_PKCS8_IMPORT_PARAMS yang terkandung dalam parameter sPrivateKeyAndParams untuk mengambil handel penyedia tempat mengimpor kunci. Jika PCRYPT_RESOLVE_HCRYPTPROV_FUNCADALAH NULL, penyedia default akan digunakan.

Fungsi ini hanya didukung untuk kunci asimetris.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header wincrypt.h
Pustaka Crypt32.lib
DLL Crypt32.dll

Lihat juga

CRYPT_PKCS8_IMPORT_PARAMS

CryptExportPKCS8Ex

CryptReleaseContext

PCRYPT_DECRYPT_PRIVATE_KEY_FUNC

PCRYPT_RESOLVE_HCRYPTPROV_FUNC