CERT_SELECT_CRITERIA 구조체(wincrypt.h)
CERT_SELECT_CRITERIA 구조체는 CertSelectCertificateChains 함수에 전달되는 선택 조건을 지정합니다.
구문
typedef struct _CERT_SELECT_CRITERIA {
DWORD dwType;
DWORD cPara;
void **ppPara;
} CERT_SELECT_CRITERIA, *PCERT_SELECT_CRITERIA;
멤버
dwType
ppPara 멤버에 사용되는 선택 조건의 유형을 지정합니다. 이 멤버는 다음 값 중 하나를 가질 수 있습니다.
| 값 | 의미 |
|---|---|
|
특정 향상된 키 사용에 따라 인증서를 선택합니다. 이 플래그가 설정되면 ppPara 는 향상된 키 사용을 지정하는 null로 끝나는 OID( 개체 식별자 ) ANSI 문자열을 참조해야 합니다.
이 조건은 인증서에서 평가됩니다. |
|
인증서의 특정 szOID_KEY_USAGE 확장에 따라 인증서를 선택합니다. 이 플래그가 설정되면 ppPara 멤버는 확장의 값이 키 사용량 비트를 식별하는 DWORD인 CERT_EXTENSION 구조를 참조해야 합니다.
이 조건은 인증서에서 평가됩니다. |
|
특정 발급 정책에 따라 인증서를 선택합니다. ppPara 멤버는 원하는 발급 정책의 null로 종료된 OID ANSI 문자열을 참조해야 합니다.
이 기준은 인증서 체인의 발급 정책에서 평가됩니다. |
|
특정 프라이빗 키 공급자를 기반으로 인증서를 선택합니다. ppPara 멤버는 공급자의 이름을 나타내는 null로 끝나는 유니코드 문자열을 참조해야 합니다. |
|
지정된 확장명 및 선택적 지정된 값의 존재에 따라 인증서를 선택합니다. ppPara 멤버는 확장 OID 및 연결된 값을 지정하는 CERT_EXTENSION 구조를 참조해야 합니다. |
|
주체 DNS 호스트 이름에 따라 인증서를 선택합니다. ppPara 멤버는 주체 호스트 이름을 포함하는 null로 끝나는 유니코드 문자열을 참조해야 합니다. 이 플래그를 기반으로 수행되는 선택 영역은 CertVerifyCertificateChainPolicy 함수를 호출하는 동안 SSL_EXTRA_CERT_CHAIN_POLICY_PARA 구조체의 pwszServerName 멤버 평가와 동일합니다.
이 조건은 인증서에서 평가됩니다. |
|
인증서 발급자의 RDN(상대 고유 이름 ) 요소에 따라 인증서를 선택합니다. ppPara 멤버는 발급자의 RDN 요소를 포함하는 CERT_RDN 구조를 참조해야 합니다.
이 조건은 인증서 체인에서 평가됩니다. |
|
인증서의 주체에서 RDN 요소를 기반으로 하는 인증서를 선택합니다. ppPara 멤버는 Subject의 RDN 요소를 포함하는 CERT_RDN 구조체에 대한 참조여야 합니다.
이 조건은 인증서에서 평가됩니다. |
|
인증서 발급자를 기반으로 인증서를 선택합니다. ppPara 멤버는 발급자의 이름을 포함하는 CERT_NAME_BLOB 구조체에 대한 참조여야 합니다.
이 조건은 인증서 체인에서 평가됩니다. |
|
인증서의 공개 키 에 따라 인증서를 선택합니다. ppPara 멤버는 공개 키가 포함된 CERT_PUBLIC_KEY_INFO 구조체에 대한 포인터를 참조해야 합니다.
이 조건은 인증서에서 평가됩니다. |
|
TLS( 전송 계층 보안 프로토콜 ) 서명 요구 사항에 따라 인증서를 선택합니다. ppPara 멤버는 SecPkgContext_SupportedSignatures 구조를 참조해야 합니다.
이 조건은 인증서에서 평가됩니다. |
cPara
ppPara 멤버에 지정된 검색 특성 수를 지정하는 DWORD 값입니다.
ppPara
하나 이상의 선택 값에 대한 포인터에 대한 포인터입니다. 데이터 형식은 dwType 멤버가 지정한 선택 유형에 따라 달라집니다. 둘 이상의 선택 값이 있는 경우 애플리케이션은 하나의 값과만 일치해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 머리글 | wincrypt.h |