ICertExit 인터페이스(certexit.h)
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 포함) |