Share via

ICertExit 인터페이스(certexit.h)

  • 아티클

ICertExit 인터페이스는 인증서 서비스 서버와 종료 모듈 간의 통신을 제공합니다.

참고 종료 모듈은 ICertServerExit 인터페이스를 사용하여 Certificate Services 서버와 통신할 수 있습니다.
 
Certificate Services 서버는 ICertExit 메서드를 호출하여 다음 작업을 수행합니다.
  • 인증서 서비스 서버를 초기화합니다.
  • 인증서 발급, CRL( 인증서 해지 목록 ) 발급 또는 서버 종료와 같은 이벤트의 종료 모듈에 알립니다.
  • 종료 모듈에 대한 설명을 검색합니다.

ICertExit 는 Certexit.h에 정의되어 있습니다. 그러나 프로그램을 만들 때는 Certsrv.h를 포함 파일로 사용합니다.

Certificate Services 인터페이스는 아파트 스레딩 및 자유 스레딩 모델을 모두 지원합니다. 더 나은 처리량을 위해 무료 스레딩이 권장됩니다.

상속

ICertExit 인터페이스는 IDispatch 인터페이스에서 상속됩니다. ICertExit 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

ICertExit 인터페이스에는 이러한 메서드가 있습니다.

 
ICertExit::GetDescription

종료 모듈 및 해당 함수에 대해 사람이 읽을 수 있는 설명을 반환합니다.
ICertExit::Initialize

자체 초기화할 때 서버 엔진에서 호출됩니다.
ICertExit::Notify

이벤트가 발생했음을 종료 모듈에 알리기 위해 서버 엔진에서 호출됩니다.

설명

ICertExit의 구현자는 ICertManageModule도 구현해야 합니다. 또한 ICertExit 를 구현하는 클래스의 ProgID는 명명 규칙을 준수해야 합니다. 특히 ProgID는 다음과 같은 형식이어야 합니다.

"MyApp. 종료"

여기서 MyApp 은 애플리케이션을 식별하는 지정자입니다. 예를 들어 C++에서는 ICertExit를 구현하는 클래스(CMyCertExitModule)의 DECLARE_REGISTRY 매크로에서 다음 코드를 사용할 수 있습니다.

DECLARE_REGISTRY(
    CMyCertExitModule,
    L"MyCode.Exit.1",
    L"MyCode.Exit",
    IDS_CERTEXITMODULE_DESC,
    THREADFLAGS_BOTH)

이전 샘플의 경우 IDS_CERTEXITMODULE_DESC 값은 클래스를 설명하는 문자열에 대한 리소스 파일(.rc)의 애플리케이션별 식별자입니다.

Certmod.h에 정의된 문자열 상수를 사용하여 명명 규칙에 따라 간소화할 수 있습니다.

상수 값
wszCERTEXITMODULE_POSTFIX TEXT(". Exit")
 

한 번에 둘 이상의 Visual Basic Scripting Edition 종료 모듈을 인증서 서비스 서버에 등록할 수 없습니다. 둘 이상의 Visual Basic Scripting Edition 종료 모듈이 등록된 경우 인증 기관 MMC 스냅인, 인증서 서비스 애플리케이션 또는 certutil 명령줄 프로그램에서 오류가 발생할 수 있습니다. Visual Basic Scripting Edition 개발 환경은 성공적으로 빌드될 때 DLL을 자동으로 등록합니다. 따라서 하나의 Visual Basic Scripting Edition 종료 모듈이 이미 등록되어 있고 다른 Visual Basic Scripting Edition 종료 모듈이 만들어지면 이러한 상황이 발생할 수 있습니다. 이러한 상황을 방지하려면 명령줄 명령줄 regsvr32 /u FileName.dll를 통해 Visual Basic Scripting Edition 종료 모듈 중 하나를 등록 취소해야 합니다. 여기서 FileName.dll 활성화되지 않은 Visual Basic Scripting Edition 종료 모듈의 이름입니다.

Visual Basic Scripting Edition의 ICertExit 구현자는 프로젝트 이름을 형식으로 지정해야 합니다.

"MyApp"

여기서 MyApp 은 애플리케이션을 식별하는 지정자입니다. 또한 ICertExit 를 구현하는 클래스의 이름은 "Exit"여야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 certexit.h(Certsrv.h 포함)

추가 정보

ICertServerExit

IDispatch