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로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 멤버는 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이 포함된 경우 이 멤버가 필요합니다. 그렇지 않으면 이 멤버는 무시됩니다. 이 멤버는 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.
| 값 | 의미 |
|---|---|
|
가져온 키가 내보낼 수 있음으로 표시됩니다. 이 플래그를 사용하지 않으면 키 핸들이 있는 CryptExportKey 함수에 대한 호출이 실패합니다. |
|
특정 작업에서 이 키를 사용하려고 할 때 대화 상자 또는 다른 방법으로 사용자에게 알림을 받습니다. 정확한 동작은 사용 중인 CSP( 암호화 서비스 공급자 )에 의해 지정됩니다.
인터넷 Explorer 4.0 이전에는 Microsoft CSP가 이 플래그를 무시했습니다. 인터넷 Explorer 4.0부터 Microsoft CSP는 이 플래그를 지원합니다. CRYPT_SILENT 플래그 집합을 사용하여 공급자 컨텍스트를 연 경우 이 플래그를 사용하면 오류가 발생하고 마지막 오류가 NTE_SILENT_CONTEXT 설정됩니다. |
|
프라이빗 키는 현재 사용자가 아닌 로컬 컴퓨터 아래에 저장됩니다. |
|
프라이빗 키는 PFX BLOB이 로컬 컴퓨터로 이동해야 한다고 지정하더라도 로컬 컴퓨터가 아닌 현재 사용자 아래에 저장됩니다. |
pwszPassword
프라이빗 키에 액세스하는 데 사용되는 암호를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. pwszFileName에 PFX BLOB이 포함된 경우 암호가 필요합니다. 암호가 필요하지 않은 경우 변수는 빈 문자열일 수 있습니다. 이 멤버는 NULL일 수 없습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | cryptuiapi.h |