CRYPTUI_WIZ_IMPORT_SRC_INFO結構 (cryptuiapi.h)
[ CRYPTUI_WIZ_IMPORT_SRC_INFO 結構可用於需求一節中指定的作業系統。 後續版本可能會變更或無法使用。]
CRYPTUI_WIZ_IMPORT_SRC_INFO結構包含要匯入CryptUIWizImport函式的主體。 主體可以是 憑證、憑證 信任清單 (CTL) ,或證書 吊銷清單 (CRL) 。
語法
typedef struct _CRYPTUI_WIZ_IMPORT_SUBJECT_INFO {
DWORD dwSize;
DWORD dwSubjectChoice;
union {
LPCWSTR pwszFileName;
PCCERT_CONTEXT pCertContext;
PCCTL_CONTEXT pCTLContext;
PCCRL_CONTEXT pCRLContext;
HCERTSTORE hCertStore;
};
DWORD dwFlags;
LPCWSTR pwszPassword;
} CRYPTUI_WIZ_IMPORT_SRC_INFO, *PCRYPTUI_WIZ_IMPORT_SRC_INFO;
成員
dwSize
這個 結構的大小,以位元組為單位。
dwSubjectChoice
指出要匯入的主體類型。 這個成員可以是下列其中一個值。
pwszFileName
Null 終止 Unicode 字串的指標,其中包含要匯入之憑證之檔案的路徑和檔案名。 如果 dwSubjectChoice 成員包含 CRYPTUI_WIZ_IMPORT_SUBJECT_FILE,則會使用此成員。
pCertContext
包含要匯入之憑證 之CERT_CONTEXT 結構的指標。 如果 dwSubjectChoice 成員包含 CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT,則會使用此成員。
pCTLContext
包含要匯入之 CTL 之CTL_CONTEXT 結構的指標。 如果 dwSubjectChoice 成員包含 CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT,則會使用此成員。
pCRLContext
包含要匯入之 CRL 之CRL_CONTEXT 結構的指標。 如果 dwSubjectChoice 成員包含 CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT,則會使用此成員。
hCertStore
要匯入之憑證存放區的控制碼。 如果 dwSubjectChoice 成員包含 CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE,則會使用此成員。
dwFlags
包含修改匯入作業的旗標。 如果 pwszFileName 包含個人資訊交換 (PFX) BLOB,則需要此成員。 否則會忽略這個成員。 這個成員可以是零或下列一或多個值的組合。
值 | 意義 |
---|---|
|
匯入的金鑰會標記為可匯出。 如果未使用此旗標,則呼叫具有金鑰控制碼的 CryptExportKey 函 式會失敗。 |
|
當使用者嘗試使用此金鑰時,會透過對話方塊或其他一些方式通知使用者。 精確行為是由正在使用的密碼編譯 服務提供者 (CSP) 所指定。
在 Internet Explorer 4.0 之前,Microsoft CSP 會忽略此旗標。 從 Internet Explorer 4.0 開始,Microsoft CSP 支援此旗標。 如果提供者內容是以 設定CRYPT_SILENT 旗標開啟,則使用此旗標會導致失敗,並將最後一個錯誤設定為 NTE_SILENT_CONTEXT。 |
|
私密金鑰會儲存在本機電腦之下,而不是儲存在目前使用者之下。 |
|
私密金鑰會儲存在目前使用者之下,而不是儲存在本機電腦之下,即使 PFX BLOB 指定它們應該位於本機電腦下也一樣。 |
pwszPassword
Null 終止的 Unicode 字串指標,其中包含用來存取 私密金鑰的密碼。 如果 pwszFileName 包含 PFX BLOB,則需要密碼。 如果不需要密碼,變數可以是空字串。 此成員不可為 Null。
規格需求
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
標頭 | cryptuiapi.h |