CryptUIWizImport 函式 (cryptuiapi.h)

  • 發行項

函式會將 憑證、憑證 信任清單 (CTL) 、證書 吊銷清單 (CRL) 或 證書存儲 匯入證書存儲。 匯入可以搭配或不使用用戶互動來執行。

語法

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

參數

[in] dwFlags

包含修改函式行為的旗標。 這可以是零或下列一或多個值的組合。

注意 除了 CRYPTUI_WIZ_NO_UI之外，下列任何常數都不會定義在已發佈的頭檔中。 若要使用這些常數，您必須使用指定的值加以定義。
 
值 意義
CRYPTUI_WIZ_NO_UI
0x0001
 此函式會根據 pImportSrc 所指向之CRYPTUI_WIZ_IMPORT_SRC_INFO結構中的資訊，執行匯入至 hDestCertStore 所指定的存放區，而不顯示任何使用者介面。 如果未指定此旗標，此函式會顯示精靈以引導使用者完成匯入程式。

從 Windows 8 和 Windows Server 2012 開始，如果您設定此旗標，並從受保護為 Active Directory (AD) 主體的 PFX BLOB 匯入憑證，而目前使用者則有權解密內嵌在 PFX 封包中的密碼，匯入將會成功，而不需要在CRYPTUI_WIZ_IMPORT_SRC_INFO中設定密碼 結構。 如需保護 PFX 至 AD 主體的詳細資訊，請參閱 pvPara 參數和 PFXExportCertStoreEx 函式的 PKCS12_PROTECT_TO_DOMAIN_SIDS 旗標。
CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS
0x0002
 隱藏 密碼編譯服務提供者 所產生的所有使用者介面， (CSP) 。 這個選項可由 CRYPTUI_WIZ_NO_UI_EXCEPT_CSP 選項覆寫。
CRYPTUI_WIZ_NO_UI_EXCEPT_CSP
0x0003
 隱藏所有使用者介面，但 CSP 所產生的介面除外。 此選項會覆寫 CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS 選項。
CRYPTUI_WIZ_IMPORT_ALLOW_CERT
0x00020000
 允許匯入憑證。
CRYPTUI_WIZ_IMPORT_ALLOW_CRL
0x00040000
 允許匯入CRL。
CRYPTUI_WIZ_IMPORT_ALLOW_CTL
0x00080000
 允許匯入 CCL。
CRYPTUI_WIZ_IMPORT_NO_CHANGE_DEST_STORE
0x00010000
 不允許使用者變更 hDestCertStore 參數所代表的目的地證書存儲。
CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE
0x00100000
 將物件匯入本機計算機的證書存儲。 這僅適用於個人資訊交換 (PFX) 匯入。
CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER
0x00200000
 將物件匯入至目前使用者的證書存儲。 這僅適用於 PFX 匯入。
CRYPTUI_WIZ_IMPORT_REMOTE_DEST_STORE
0x00400000
 將物件匯入遠端證書存儲。 如果 hDestCertStore 參數代表遠端證書存儲，請設定此旗標。

[in] hwndParent

做為這個函式所建立之對話框之父系的視窗句柄。 如果在 dwFlags 中設定了CRYPTUI_WIZ_NO_UI旗標，則會忽略此參數。

[in] pwszWizardTitle

Null 終止 Unicode 字串的指標，其中包含要用於此函式所建立之對話框中的標題。 如果在 dwFlags 中設定了CRYPTUI_WIZ_NO_UI旗標，則會忽略此參數。

[in] pImportSrc

包含要匯入之對象相關信息 之CRYPTUI_WIZ_IMPORT_SRC_INFO 結構的指標。 如果CRYPTUI_WIZ_NO_UI是在 dwFlags 中設定，則為必要參數，否則為選擇性參數。

[in] hDestCertStore

要匯入至之證書存儲的句柄。 如果此參數為 NULL，且未在 dwFlags 中設定CRYPTUI_WIZ_NO_UI旗標，精靈會提示使用者選取證書存儲。

傳回值

如果函式成功，函式會傳回非零。

如果函式失敗，它會傳回零。 如需擴充錯誤資訊，請呼叫 GetLastError 函式。

備註

如果 dwFlags 中未設定下列三個旗標，則允許匯入任何類型的內容：

  • CRYPTUI_WIZ_IMPORT_ALLOW_CERT
  • CRYPTUI_WIZ_IMPORT_ALLOW_CRL
  • CRYPTUI_WIZ_IMPORT_ALLOW_CTL
CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE和CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER旗標可用來強制 PFX BLOB 的內容進入本機計算機存放區或目前的使用者存放區。 如果這兩個旗標都未設定， 且 hDestCertStore 為 NULL：
  • PFX BLOB 中的私鑰將會強制匯入目前的使用者存放區。
  • 如果未設定 CRYPTUI_WIZ_NO_UI ，精靈會提示使用者從目前的使用者證書存儲中選取證書存儲。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 cryptuiapi.h
程式庫 Cryptui.lib
Dll Cryptui.dll

另請參閱

CRYPTUI_WIZ_IMPORT_SRC_INFO

CryptUIWizExport