Fungsi CryptUIWizImport (cryptuiapi.h)

Artikel
03/14/2023

Fungsi mengimpor sertifikat, daftar kepercayaan sertifikat (CTL), daftar pencabutan sertifikat (CRL), atau penyimpanan sertifikat ke penyimpanan sertifikat. Impor dapat dilakukan dengan atau tanpa interaksi pengguna.

Sintaks

BOOL CryptUIWizImport(
  [in] DWORD                         dwFlags,
  [in] HWND                          hwndParent,
  [in] LPCWSTR                       pwszWizardTitle,
  [in] PCCRYPTUI_WIZ_IMPORT_SRC_INFO pImportSrc,
  [in] HCERTSTORE                    hDestCertStore
);

Parameter

[in] dwFlags

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

Catatan Kecuali untuk CRYPTUI_WIZ_NO_UI, tidak ada konstanta berikut yang ditentukan dalam file header yang diterbitkan. Untuk menggunakan konstanta ini, Anda harus menentukannya dengan menggunakan nilai yang ditentukan.

Nilai	Makna
CRYPTUI_WIZ_NO_UI 0x0001	Fungsi ini akan melakukan impor berdasarkan informasi dalam struktur CRYPTUI_WIZ_IMPORT_SRC_INFO yang ditunjukkan oleh pImportSrc ke dalam penyimpanan yang ditentukan oleh hDestCertStore tanpa menampilkan antarmuka pengguna apa pun. Jika bendera ini tidak ditentukan, fungsi ini akan menampilkan wizard untuk memandu pengguna melalui proses impor. Dimulai dengan Windows 8 dan Windows Server 2012, jika Anda mengatur bendera ini dan mengimpor sertifikat dari BLOB PFX yang dilindungi ke prinsipal Direktori Aktif (AD), dan pengguna saat ini, sebagai bagian dari prinsipal tersebut, memiliki izin untuk mendekripsi kata sandi yang disematkan dalam paket PFX, impor akan berhasil tanpa mengharuskan kata sandi diatur dalam struktur CRYPTUI_WIZ_IMPORT_SRC_INFO. Untuk informasi selengkapnya tentang melindungi PFX ke perwakilan AD, lihat parameter pvPara dan bendera PKCS12_PROTECT_TO_DOMAIN_SIDS fungsi PFXExportCertStoreEx .
CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS 0x0002	Menekan semua antarmuka pengguna yang dihasilkan oleh penyedia layanan kriptografi (CSP). Opsi ini dapat ditimpa oleh opsi CRYPTUI_WIZ_NO_UI_EXCEPT_CSP .
CRYPTUI_WIZ_NO_UI_EXCEPT_CSP 0x0003	Tekan semua antarmuka pengguna kecuali yang dihasilkan oleh CSP. Opsi ini mengambil alih opsi CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS .
CRYPTUI_WIZ_IMPORT_ALLOW_CERT 0x00020000	Perbolehkan sertifikat diimpor.
CRYPTUI_WIZ_IMPORT_ALLOW_CRL 0x00040000	Izinkan CRL diimpor.
CRYPTUI_WIZ_IMPORT_ALLOW_CTL 0x00080000	Izinkan CTL untuk diimpor.
CRYPTUI_WIZ_IMPORT_NO_CHANGE_DEST_STORE 0x00010000	Jangan izinkan pengguna untuk mengubah penyimpanan sertifikat tujuan yang diwakili oleh parameter hDestCertStore .
CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE 0x00100000	Impor objek ke penyimpanan sertifikat untuk komputer lokal. Ini hanya berlaku untuk impor Personal Information Exchange (PFX).
CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER 0x00200000	Impor objek ke penyimpanan sertifikat untuk pengguna saat ini. Ini hanya berlaku untuk impor PFX.
CRYPTUI_WIZ_IMPORT_REMOTE_DEST_STORE 0x00400000	Impor objek ke penyimpanan sertifikat jarak jauh. Atur bendera ini jika parameter hDestCertStore mewakili penyimpanan sertifikat jarak jauh.

[in] hwndParent

Gagang jendela yang akan digunakan sebagai induk kotak dialog yang dibuat fungsi ini. Parameter ini diabaikan jika bendera CRYPTUI_WIZ_NO_UI diatur dalam dwFlags.

[in] pwszWizardTitle

Penunjuk ke string Unicode yang dihentikan null yang berisi judul yang akan digunakan dalam kotak dialog yang dibuat fungsi ini. Parameter ini diabaikan jika bendera CRYPTUI_WIZ_NO_UI diatur dalam dwFlags.

[in] pImportSrc

Penunjuk ke struktur CRYPTUI_WIZ_IMPORT_SRC_INFO yang berisi informasi tentang objek yang akan diimpor. Parameter ini diperlukan jika CRYPTUI_WIZ_NO_UI diatur dalam dwFlags dan opsional jika tidak.

[in] hDestCertStore

Handel ke penyimpanan sertifikat untuk diimpor. Jika parameter ini NULL dan bendera CRYPTUI_WIZ_NO_UI tidak diatur dalam dwFlags, wizard akan meminta pengguna untuk memilih penyimpanan sertifikat.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Keterangan

Jika tidak ada tiga bendera berikut yang diatur dalam dwFlags, impor semua jenis konten diizinkan:

CRYPTUI_WIZ_IMPORT_ALLOW_CERT
CRYPTUI_WIZ_IMPORT_ALLOW_CRL
CRYPTUI_WIZ_IMPORT_ALLOW_CTL

Bendera CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE dan CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER digunakan untuk memaksa konten BLOB PFX ke penyimpanan komputer lokal atau penyimpanan pengguna saat ini. Jika tidak ada bendera ini yang diatur dan hDestCertStore adalah NULL:

Kunci privat dalam BLOB PFX akan dipaksa untuk diimpor ke penyimpanan pengguna saat ini.
Dan jika CRYPTUI_WIZ_NO_UI tidak diatur, wizard meminta pengguna untuk memilih penyimpanan sertifikat dari antara penyimpanan sertifikat pengguna saat ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	cryptuiapi.h
Pustaka	Cryptui.lib
DLL	Cryptui.dll

Lihat juga

CRYPTUI_WIZ_IMPORT_SRC_INFO

CryptUIWizExport

Bagikan melalui