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
함수의 동작을 수정하는 플래그를 포함합니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.
| 값 | 의미 |
|---|---|
|
이 함수는 사용자 인터페이스를 표시하지 않고 pImportSrc가 가리키는 CRYPTUI_WIZ_IMPORT_SRC_INFO 구조의 정보를 기반으로 hDestCertStore로 지정된 저장소로 가져오기를 수행합니다. 이 플래그를 지정하지 않으면 이 함수는 가져오기 프로세스를 통해 사용자를 안내하는 마법사를 표시합니다.
Windows 8 및 Windows Server 2012 시작하여 이 플래그를 설정하고 AD(Active Directory) 보안 주체로 보호된 PFX BLOB에서 인증서를 가져오고 현재 사용자에게 PFX 패킷에 포함된 암호를 해독할 수 있는 권한이 있는 경우 CRYPTUI_WIZ_IMPORT_SRC_INFO 구조. PFX를 AD 보안 주체로 보호하는 방법에 대한 자세한 내용은 PFXExportCertStoreEx 함수의 pvPara 매개 변수 및 PKCS12_PROTECT_TO_DOMAIN_SIDS 플래그를 참조하세요. |
|
CSP( 암호화 서비스 공급자 )에서 생성된 모든 사용자 인터페이스를 표시하지 않습니다. 이 옵션은 CRYPTUI_WIZ_NO_UI_EXCEPT_CSP 옵션으로 재정의할 수 있습니다. |
|
CSP에서 생성된 인터페이스를 제외한 모든 사용자 인터페이스를 표시하지 않습니다. 이 옵션은 CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS 옵션을 재정의합니다. |
|
인증서를 가져올 수 있도록 허용합니다. |
|
CRL을 가져올 수 있도록 허용합니다. |
|
CTL을 가져올 수 있도록 허용합니다. |
|
사용자가 hDestCertStore 매개 변수로 표시되는 대상 인증서 저장소를 변경할 수 없습니다. |
|
개체를 로컬 컴퓨터의 인증서 저장소로 가져옵니다. 이는 PFX(개인 정보 교환) 가져오기에만 적용됩니다. |
|
개체를 현재 사용자의 인증서 저장소로 가져옵니다. 이는 PFX 가져오기에만 적용됩니다. |
|
개체를 원격 인증서 저장소로 가져옵니다. hDestCertStore 매개 변수가 원격 인증서 저장소를 나타내는 경우 이 플래그를 설정합니다. |
[in] hwndParent
이 함수가 만드는 대화 상자의 부모로 사용할 창의 핸들입니다. CRYPTUI_WIZ_NO_UI 플래그가 dwFlags에 설정된 경우 이 매개 변수는 무시됩니다.
[in] pwszWizardTitle
이 함수가 만드는 대화 상자에서 사용할 제목이 포함된 null로 끝나는 유니코드 문자열에 대한 포인터입니다. CRYPTUI_WIZ_NO_UI 플래그가 dwFlags에 설정된 경우 이 매개 변수는 무시됩니다.
[in] pImportSrc
가져올 개체에 대한 정보를 포함하는 CRYPTUI_WIZ_IMPORT_SRC_INFO 구조체에 대한 포인터입니다. 이 매개 변수는 CRYPTUI_WIZ_NO_UIdwFlags 에서 설정되고 그렇지 않으면 선택 사항인 경우에 필요합니다.
[in] hDestCertStore
가져올 인증서 저장소에 대한 핸들입니다. 이 매개 변수가 NULL 이고 CRYPTUI_WIZ_NO_UI 플래그가 dwFlags에 설정되지 않은 경우 마법사는 사용자에게 인증서 저장소를 선택하라는 메시지를 표시합니다.
반환 값
함수가 성공하면 함수는 0이 아닌 값을 반환합니다.
함수가 실패하면 0을 반환합니다. 확장된 오류 정보는 GetLastError 함수를 호출합니다.
설명
다음 세 가지 플래그 중 dwFlags에 설정되지 않은 경우 모든 형식의 콘텐츠 가져오기가 허용됩니다.
- CRYPTUI_WIZ_IMPORT_ALLOW_CERT
- CRYPTUI_WIZ_IMPORT_ALLOW_CRL
- CRYPTUI_WIZ_IMPORT_ALLOW_CTL
- PFX BLOB 의 프라이빗 키를 현재 사용자 저장소로 강제로 가져와야 합니다.
- CRYPTUI_WIZ_NO_UI 설정되지 않은 경우 마법사는 사용자에게 현재 사용자 인증서 저장소 중에서 인증서 저장소를 선택하라는 메시지를 표시합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | cryptuiapi.h |
| 라이브러리 | Cryptui.lib |
| DLL | Cryptui.dll |