Share via

CERT_SELECT_STRUCT_W 구조체(cryptdlg.h)

  • 아티클

CERT_SELECT_STRUCT 구조에는 인증서 선택 대화 상자에 표시되는 인증서를 선택할 기준이 포함되어 있습니다. 이 구조체는 CertSelectCertificate 함수에 사용됩니다.

구문

typedef struct tagCSSW {
  DWORD           dwSize;
  HWND            hwndParent;
  HINSTANCE       hInstance;
  LPCWSTR         pTemplateName;
  DWORD           dwFlags;
  LPCWSTR         szTitle;
  DWORD           cCertStore;
  HCERTSTORE      *arrayCertStore;
  LPCSTR          szPurposeOid;
  DWORD           cCertContext;
  PCCERT_CONTEXT  *arrayCertContext;
  LPARAM          lCustData;
  PFNCMHOOKPROC   pfnHook;
  PFNCMFILTERPROC pfnFilter;
  LPCWSTR         szHelpFileName;
  DWORD           dwHelpId;
  HCRYPTPROV      hprov;
} CERT_SELECT_STRUCT_W, *PCERT_SELECT_STRUCT_W;

멤버

dwSize

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

hwndParent

CertSelectCertificate에서 생성하는 대화 상자의 부모 창에 대한 핸들입니다.

hInstance

실행 파일에 대화 상자 템플릿이 포함된 모듈에 대한 핸들입니다.

pTemplateName

dwFlags 멤버에서 CSS_ENABLETEMPLATE 플래그를 설정한 경우 dialogBoxIndirectParam에서 대화 상자를 만드는 데 사용하는 템플릿이 포함된 전역 메모리 개체에 대한 포인터로 pTemplateName을 설정합니다. 대화 상자 템플릿은 대화 상자를 설명하는 헤더로 구성됩니다. 헤더 뒤에는 대화 상자의 각 컨트롤을 설명하는 하나 이상의 추가 데이터 블록이 옵니다. 템플릿은 표준 형식 또는 확장 형식을 사용할 수 있습니다.

CSS_ENABLETEMPLATEHANDLE 플래그가 dwFlags로 설정된 경우 pTemplateName은 대화 상자 템플릿을 지정합니다. pTemplateName 은 대화 상자 템플릿의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터이거나 대화 상자 템플릿의 리소스 식별자를 지정하는 정수 값입니다. 가 리소스 식별자를 지정하는 경우 해당 상위 단어는 0이어야 하며 하위 단어에는 식별자가 포함되어야 합니다. 이 정수 값을 만드는 한 가지 방법은 MAKEINTRESOURCE 매크로를 사용하는 것입니다.

dwFlags

이 멤버는 다음 값 중 하나 이상일 수 있습니다.

값 의미
CSS_HIDE_PROPERTIES
 속성 단추를 숨깁니다.
CSS_ENABLEHOOK
 pfnHook에서 후크 프로시저를 전달합니다.
CSS_ALLOWMULTISELECT
 여러 인증서 선택을 사용하도록 설정합니다. 이 옵션은 현재 지원되지 않으며 무시됩니다.
CSS_SHOW_HELP
 도움말 단추를 표시합니다.
CSS_ENABLETEMPLATE
 CertSelectCertificate 함수가 DialogBoxIndirectParam 함수를 호출하여 대화 상자를 만들도록 합니다. 자세한 내용은 pTemplateName을 참조하세요.
CSS_ENABLETEMPLATEHANDLE
 CertSelectCertificate 함수가 DialogBoxParam 함수를 호출하여 대화 상자를 만들도록 합니다. 자세한 내용은 pTemplateName을 참조하세요.

szTitle

대화 상자 제목에 대한 텍스트가 포함된 문자열에 대한 포인터입니다.

cCertStore

arrayCertStore 배열의 요소 수입니다.

arrayCertStore

대화 상자가 열거하고 인증서를 표시하는 인증서 배열에 대한 포인터입니다. cCertStore 멤버에는 이 배열의 요소 수가 포함됩니다.

szPurposeOid

EKU(향상된 키 사용)에 대한 OID(개체 식별자)의 문자열 표현에 대한 포인터입니다. OID가 제공되면 이 EKU를 포함하는 인증서만 표시됩니다.

cCertContext

arrayCertContext 배열의 요소 수입니다. CertSelectCertificate 함수가 반환된 후 이 멤버에는 사용자가 선택한 인증서 수가 포함됩니다. 현재 사용자가 인증서를 하나만 선택할 수 있습니다.

arrayCertContext

CERT_CONTEXT 구조체 배열에 대한 포인터입니다. cCertContext 멤버는 이 배열의 요소 수를 지정합니다. 이 배열에는 하나 이상의 요소가 포함되어야 합니다.

이러한 구조체가 나타내는 인증서는 CertSelectCertificate 함수에 의해 표시되는 대화 상자가 처음 표시될 때 선택됩니다. 현재 이 배열의 첫 번째 인증서만 사용됩니다. CertSelectCertificate 함수가 성공하면 이 배열의 첫 번째 인증서가 CertFreeCertificateContext 함수와 함께 릴리스됩니다. 이 배열의 첫 번째 요소가 NULL이면 처음에 대화 상자에서 인증서가 선택되지 않습니다.

CertSelectCertificate 함수가 반환된 후 이 배열에는 사용자가 선택한 인증서가 포함됩니다. 현재 사용자가 인증서를 하나만 선택할 수 있습니다.

lCustData

pfnFilter에서 참조하는 필터 프로시저로 전달되는 사용자 지정 데이터를 보유하는 바이트 값 배열에 대한 포인터입니다. 이 사용자 지정 데이터는 CertSelectCertificate 함수에서 사용되지 않습니다.

pfnHook

후크 콜백 함수에 대한 PFNCMHOOKPROC 함수 포인터입니다. 이 함수는 대화 상자에서 메시지를 처리하기 전에 호출됩니다. 자세한 내용은 후크를 참조하세요.

pfnFilter

필터 콜백 함수에 대한 PFNCMFILTERPROC 함수 포인터입니다. 대화 상자에서 표시할 인증서를 결정하기 위해 호출됩니다.

szHelpFileName

도움말 파일의 전체 경로를 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

dwHelpId

토픽의 컨텍스트 식별자입니다. 자세한 내용은
WinHelp.

hprov

인증서 확인에 사용할 CSP( 암호화 서비스 공급자 )에 대한 핸들입니다.

설명

참고

cryptdlg.h 헤더는 CERT_SELECT_STRUCT 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

CertSelectCertificate