CRYPTUI_SELECTCERTIFICATE_STRUCT 구조체

CRYPTUI_SELECTCERTIFICATE_STRUCT 구조에는 CryptUIDlgSelectCertificate 함수에 의해 표시되는 대화 상자에 대한 정보가 포함되어 있습니다.

구문

typedef struct _CRYPTUI_SELECTCERTIFICATE_STRUCT {
  DWORD               dwSize;
  HWND                hwndParent;
  DWORD               dwFlags;
  LPCTSTR             szTitle;
  DWORD               dwDontUseColumn;
  LPCTSTR             szDisplayString;
  PFNCFILTERPROC      pFilterCallback;
  PFNCCERTDISPLAYPROC pDisplayCallback;
  void                *pvCallbackData;
  DWORD               cDisplayStores;
  HCERTSTORE          *rghDisplayStores;
  DWORD               cStores;
  HCERTSTORE          *rghStores;
  DWORD               cPropSheetPages;
  LPCPROPSHEETPAGE    rgPropSheetPages;
  HCERTSTORE          hSelectedCertStore;
} CRYPTUI_SELECTCERTIFICATE_STRUCT, *PCRYPTUI_SELECTCERTIFICATE_STRUCT;

멤버

dwSize

이 구조체의 크기(바이트)입니다.

hwndParent

대화 상자의 부모 창 핸들입니다. 이 값이 NULL이면 부모 창이 기본 데스크톱 창입니다.

dwFlags

CryptUIDlgSelectCertificate 함수에 대한 추가 옵션을 지정합니다. 이 값은 다음 값의 0 또는 비트 OR 일 수 있습니다.

값	의미
CRYPTUI_SELECTCERT_ADDFROMDS	예약되어 있습니다.
CRYPTUI_SELECTCERT_LEGACY	레거시 대화 상자를 표시하도록 지정합니다.
CRYPTUI_SELECTCERT_MULTISELECT	사용자가 대화 상자에서 둘 이상의 인증서를 선택할 수 있습니다. 이 플래그가 설정되면 CryptUIDlgSelectCertificate 함수는 항상 NULL을 반환합니다. 이 구조체의 hSelectedCertStore 멤버는 인증서 저장소에 대한 핸들을 포함해야 합니다. 사용자가 선택한 인증서가 이 저장소에 추가됩니다.
CRYPTUI_SELECTCERT_PUT_WINDOW_TOPMOST	암호화 UI가 화면의 위쪽 창이 되도록 합니다.

 

szTitle

대화 상자의 표시 제목입니다. 이 멤버의 값이 NULL이면 "인증서 선택"의 기본 제목이 사용됩니다.

dwDontUseColumn

디스플레이 열을 제외하기 위해 결합할 수 있는 플래그입니다.

값	의미
CRYPTUI_SELECT_ISSUEDTO_COLUMN 1(0x1)	ISSUEDTO 정보를 표시하지 마세요.
CRYPTUI_SELECT_ISSUEDBY_COLUMN 2(0x2)	ISSUEDBY 정보를 표시하지 마세요.
CRYPTUI_SELECT_INTENDEDUSE_COLUMN 4(0x4)	IntendedUse 정보를 표시하지 마세요.
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN 8(0x8)	이름 정보를 표시하지 마세요.
CRYPTUI_SELECT_LOCATION_COLUMN 16(0x10)	위치 정보를 표시하지 마세요.
CRYPTUI_SELECT_EXPIRATION_COLUMN 32(0x20)	만료 정보를 표시하지 마세요.

 

szDisplayString

사용자에게 지시하기 위해 대화 상자에 표시되는 텍스트입니다. 이 멤버의 값이 NULL이면 기본 문자열 "사용하려는 인증서 선택"이 사용됩니다.

pFilterCallback

대화 상자에 표시되는 인증서를 필터링하는 PFNCFILTERPROC 콜백 함수에 대한 포인터입니다.

pDisplayCallback

사용자가 보도록 선택한 인증서를 표시하는 PFNCCERTDISPLAYPROC 콜백 함수에 대한 포인터입니다.

pvCallbackData

pFilterCallback 및 pDisplayCallback 멤버가 지정한 콜백 함수에 전달되는 추가 데이터입니다.

cDisplayStores

rghDisplayStores 배열의 인증서 저장소 수입니다.

rghDisplayStores

대화 상자에서 선택할 수 있는 인증서가 포함된 저장소 배열에 대한 포인터입니다.

cStores

rghStores 배열의 인증서 저장소 수입니다.

rghStores

인증서 체인을 빌드하고 대화 상자에 표시된 인증서에 대한 신뢰를 확인할 때 검색할 인증서 저장소 배열에 대한 포인터입니다.

cPropSheetPages

rgPropSheetPages 배열의 속성 페이지 수입니다.

rgPropSheetPages

인증서를 보기 위해 선택할 때 인증서 보기 대화 상자에 전달되는 속성 페이지를 나타내는 PROPSHEETPAGE 구조의 배열에 대한 포인터입니다.

hSelectedCertStore

호출자가 만든 인증서 저장소에 대한 핸들입니다. 사용자가 선택한 인증서가 이 저장소에 추가됩니다. 이 저장소의 인증서 수가 CryptUIDlgSelectCertificate를 호출하기 전과 후에 동일한 경우 사용자는 인증서를 선택하지 않고 대화 상자를 닫았습니다.

이 구조체의 dwFlags 멤버에 CRYPTUI_SELECTCERT_MULTISELECT 플래그가 없는 경우 이 멤버는 사용되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
유니코드 및 ANSI 이름	CRYPTUI_SELECTCERTIFICATE_STRUCTW (유니코드) 및 CRYPTUI_SELECTCERTIFICATE_STRUCTA (ANSI)

참고 항목

CryptUIDlgSelectCertificate