CryptUIDlgSelectCertificate 함수

CryptUIDlgSelectCertificate 함수는 사용자가 인증서를 선택할 수 있는 대화 상자를 표시합니다.

구문

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

매개 변수

pcsc [in]

표시할 대화 상자에 대한 정보가 포함된 CRYPTUI_SELECTCERTIFICATE_STRUCT 구조체에 대한 포인터입니다.

반환 값

사용자가 선택한 인증서를 나타내는 CERT_CONTEXT 구조체에 대한 포인터입니다. 이 인증서 사용을 마쳤으면 인증서 컨텍스트의 참조 수를 감소하려면 이 포인터를 CertFreeCertificateContext 함수에 전달해야 합니다.

pcsc 구조의 dwFlags 멤버에 CRYPTUI_SELECTCERT_MULTISELECT 플래그가 없는 경우 반환 값 NULL은 사용자가 인증서를 선택하지 않고 대화 상자를 닫았다는 것을 의미합니다.

pcsc 구조체의 dwFlags 멤버에 CRYPTUI_SELECTCERT_MULTISELECT 플래그가 포함된 경우 이 함수는 항상 NULL을 반환합니다. 선택한 인증서는 pcsc의 hSelectedCertStore 멤버로 표시되는 인증서 저장소에 포함됩니다. 저장소의 인증서 수가 CryptUIDlgSelectCertificate를 호출하기 전과 후에 동일한 경우 사용자는 인증서를 선택하지 않고 대화 상자를 닫았습니다.

설명

CRYPTUI_SELECTCERTIFICATE_STRUCT 구조체의 dwFlags 멤버가 CRYPTUI_SELECTCERT_LEGACY 설정되면 레거시 대화 상자가 표시됩니다. 그렇지 않으면 현재 인증서 선택 대화 상자가 표시됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
지원 종료	Windows 7 [데스크톱 앱만 해당]
라이브러리	Cryptui.lib
DLL	Cryptui.dll
유니코드 및 ANSI 이름	CryptUIDlgSelectCertificateW (유니코드) 및 CryptUIDlgSelectCertificateA (ANSI)

추가 정보

CRYPTUI_SELECTCERTIFICATE_STRUCT