Share via

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

가져올 주체의 유형을 나타냅니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
CRYPTUI_WIZ_IMPORT_SUBJECT_FILE
 pwszFileName 멤버에서 참조되는 파일에 저장된 인증서를 가져옵니다.
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT
 pCertContext 멤버에서 참조되는 인증서를 가져옵니다.
CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT
 pCTLContext 멤버에서 참조되는 CTL을 가져옵니다.
CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT
 pCRLContext 멤버에서 참조되는 CRL을 가져옵니다.
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE
 hCertStore 멤버에서 참조되는 인증서 저장소를 가져옵니다.

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

값 의미
CRYPT_EXPORTABLE
 가져온 키가 내보낼 수 있음으로 표시됩니다. 이 플래그를 사용하지 않으면 키 핸들이 있는 CryptExportKey 함수에 대한 호출이 실패합니다.
CRYPT_USER_PROTECTED
 특정 작업에서 이 키를 사용하려고 할 때 대화 상자 또는 다른 방법으로 사용자에게 알림을 받습니다. 정확한 동작은 사용 중인 CSP( 암호화 서비스 공급자 )에 의해 지정됩니다.

인터넷 Explorer 4.0 이전에는 Microsoft CSP가 이 플래그를 무시했습니다. 인터넷 Explorer 4.0부터 Microsoft CSP는 이 플래그를 지원합니다.

CRYPT_SILENT 플래그 집합을 사용하여 공급자 컨텍스트를 연 경우 이 플래그를 사용하면 오류가 발생하고 마지막 오류가 NTE_SILENT_CONTEXT 설정됩니다.
CRYPT_MACHINE_KEYSET
 프라이빗 키는 현재 사용자가 아닌 로컬 컴퓨터 아래에 저장됩니다.
CRYPT_USER_KEYSET
 프라이빗 키는 PFX BLOB이 로컬 컴퓨터로 이동해야 한다고 지정하더라도 로컬 컴퓨터가 아닌 현재 사용자 아래에 저장됩니다.

pwszPassword

프라이빗 키에 액세스하는 데 사용되는 암호를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. pwszFileName에 PFX BLOB이 포함된 경우 암호가 필요합니다. 암호가 필요하지 않은 경우 변수는 빈 문자열일 수 있습니다. 이 멤버는 NULL일 수 없습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 cryptuiapi.h

추가 정보

CRYPTUI_WIZ_EXPORT_INFO

CryptUIWizExport