ICertServerPolicy 인터페이스(certif.h)

ICertServerPolicy 인터페이스를 사용하면 정책 모듈이 Certificate Services와 통신할 수 있습니다.

참고 Certificate Services는 ICertPolicy2 인터페이스를 통해 정책 모듈과 통신합니다.

 

ICertServerPolicy 인터페이스는 서버 엔진에서 내보내고 정책 모듈에서 호출되어 다음 작업을 수행합니다.

• 후속 작업의 현재 컨텍스트로 사용되는 인증서 요청을 지정합니다.
• 인증서 요청의 확장(확장 플래그 포함)을 열거하고 검색하고 발급된 인증서의 확장을 설정합니다.
• 요청 특성을 열거하고 검색합니다.
• 인증서 요청 속성을 검색합니다.
• 인증서 속성을 검색하고 설정합니다.

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 포함)

추가 정보

ICertAdmin::ResubmitRequest

ICertAdmin::SetRequestAttributes

ICertPolicy::VerifyRequest

ICertRequest

ICertRequest::Submit

IDispatch