ICertServerPolicy 인터페이스(certif.h)
ICertServerPolicy 인터페이스를 사용하면 정책 모듈이 Certificate Services와 통신할 수 있습니다.
참고 Certificate Services는 ICertPolicy2 인터페이스를 통해 정책 모듈과 통신합니다.
- 후속 작업의 현재 컨텍스트로 사용되는 인증서 요청을 지정합니다.
- 인증서 요청의 확장(확장 플래그 포함)을 열거하고 검색하고 발급된 인증서의 확장을 설정합니다.
- 요청 특성을 열거하고 검색합니다.
- 인증서 요청 속성을 검색합니다.
- 인증서 속성을 검색하고 설정합니다.
ICertPolicy::VerifyRequest 메서드가 반환될 때까지 호출될 때부터 생성 중인 해결되지 않은 요청 및 인증서는 Context 데이터 개체를 통해 액세스할 수 있습니다. 정책 모듈은 ICertServerPolicy::SetCertificateProperty를 호출하여 요청 속성을 추가하거나 재정의할 수 있으므로 인증서 속성은 요청 속성과 다를 수 있습니다.
ICertServerPolicy 는 Certif.h에 정의되어 있습니다. 그러나 프로그램을 만들 때 Certsrv.h를 포함 파일로 사용합니다. Certcli.dll ICertServerPolicy 인터페이스를 제공합니다. 이 인터페이스의 형식 정보는 SDK(플랫폼 소프트웨어 개발 키트)와 함께 제공되는 Certclil.dll 있습니다.
Certificate Services 인터페이스는 아파트 스레딩 및 자유 스레딩 모델을 모두 지원합니다. 더 나은 처리량을 위해 무료 스레딩을 사용하는 것이 좋습니다.
상속
ICertServerPolicy 인터페이스는 IDispatch 인터페이스에서 상속됩니다. ICertServerPolicy 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
ICertServerPolicy 인터페이스에는 이러한 메서드가 있습니다.
| ICertServerPolicy::EnumerateAttributes 현재 특성의 이름을 검색하고 내부 열거형 포인터를 다음 특성으로 이동합니다. |
| ICertServerPolicy::EnumerateAttributesClose 특성 열거형으로 연결된 리소스를 해제합니다. |
| ICertServerPolicy::EnumerateAttributesSetup 현재 컨텍스트와 연결된 첫 번째 요청 특성에 대한 내부 열거형 포인터를 초기화합니다. (ICertServerPolicy.EnumerateAttributesSetup) |
| ICertServerPolicy::EnumerateExtensions 현재 확장의 OID(개체 식별자)를 검색하고 내부 열거형 포인터를 다음 확장으로 이동합니다. |
| ICertServerPolicy::EnumerateExtensionsClose 확장 열거형으로 연결된 리소스를 해제합니다. |
| ICertServerPolicy::EnumerateExtensionsSetup 현재 컨텍스트와 연결된 첫 번째 인증서 확장에 대한 내부 열거형 포인터를 초기화합니다. (ICertServerPolicy.EnumerateExtensionsSetup) |
| ICertServerPolicy::GetCertificateExtension 특정 인증서 확장을 검색합니다. |
| ICertServerPolicy::GetCertificateExtensionFlags GetCertificateExtension에 대한 최신 호출에서 획득한 확장과 연결된 플래그를 검색합니다. |
| ICertServerPolicy::GetCertificateProperty 인증서에서 명명된 속성을 반환합니다. (ICertServerPolicy.GetCertificateProperty) |
| ICertServerPolicy::GetRequestAttribute 요청에서 명명된 특성을 반환합니다. |
| ICertServerPolicy::GetRequestProperty 요청에서 특정 속성을 검색합니다. |
| ICertServerPolicy::SetCertificateExtension 인증서에 새 확장을 추가합니다. |
| ICertServerPolicy::SetCertificateProperty 인증서와 연결된 속성을 설정하려면 |
| ICertServerPolicy::SetContext 인증서 서비스에 대한 후속 호출의 컨텍스트로 사용할 요청을 지정합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | certif.h(Certsrv.h 포함) |