다음을 통해 공유

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이거나 다음 값 중 하나 이상의 조합일 수 있습니다.

참고CRYPTUI_WIZ_NO_UI 제외하고 게시된 헤더 파일에는 다음 상수가 정의되지 않습니다. 이러한 상수를 사용하려면 지정된 값을 사용하여 해당 상수를 정의해야 합니다.
 
값 의미
CRYPTUI_WIZ_NO_UI
0x0001
 이 함수는 사용자 인터페이스를 표시하지 않고 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 플래그를 참조하세요.
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
 CTL을 가져올 수 있도록 허용합니다.
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

이 함수가 만드는 대화 상자의 부모로 사용할 창의 핸들입니다. 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
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