ICertExit-Schnittstelle (certexit.h)

Die ICertExit-Schnittstelle stellt die Kommunikation zwischen dem Zertifikatdiensteserver und einem Exitmodul bereit.

Hinweis Das Exitmodul kann über die ICertServerExit-Schnittstelle mit dem Zertifikatdiensteserver kommunizieren.

 

Der Zertifikatdiensteserver ruft die ICertExit-Methoden auf, um die folgenden Aufgaben auszuführen:

• Initialisieren Sie den Zertifikatdiensteserver.
• Benachrichtigen Sie das Exitmodul über ein Ereignis, z. B. die Zertifikatausstellung, die Ausstellung der Zertifikatsperrliste (Certificate Revocation List , CRL) oder das Herunterfahren des Servers.
• Rufen Sie eine Beschreibung des Exitmoduls ab.

ICertExit ist in Certexit.h definiert. Wenn Sie Ihr Programm erstellen, verwenden Sie jedoch Certsrv.h als Includedatei.

Zertifikatdienstschnittstellen unterstützen sowohl Apartmentthreading- als auch Free-Threading-Modelle. Für einen besseren Durchsatz wird freies Threading empfohlen.

Vererbung

Die ICertExit-Schnittstelle erbt von der IDispatch-Schnittstelle . ICertExit verfügt auch über folgende Arten von Membern:

Methoden

Die ICertExit-Schnittstelle verfügt über diese Methoden.

ICertExit::GetDescription Gibt eine lesbare Beschreibung des Exitmoduls und seiner Funktion zurück.
ICertExit::Initialize Wird von der Server-Engine aufgerufen, wenn sie sich selbst initialisiert.
ICertExit::Notify Wird von der Server-Engine aufgerufen, um ein Exitmodul zu benachrichtigen, dass ein Ereignis aufgetreten ist.

Hinweise

Implementierer von ICertExit sollten auch ICertManageModule implementieren. Darüber hinaus muss die ProgID für eine Klasse, die ICertExit implementiert, einer Benennungskonvention entsprechen. Insbesondere muss die ProgID folgende Form aufweisen:

"MyApp. Beenden"

Dabei ist MyApp ein Spezifizierer, der die Anwendung identifiziert. In C++ kann beispielsweise der folgende Code im DECLARE_REGISTRY Makro einer Klasse (CMyCertExitModule) verwendet werden, die ICertExit implementiert.

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

Im vorherigen Beispiel ist der IDS_CERTEXITMODULE_DESC Wert ein anwendungsspezifischer Bezeichner in der Ressourcendatei (.rc) für eine Zeichenfolge, die die -Klasse beschreibt.

Zeichenfolgenkonstanten, die in Certmod.h definiert sind, können verwendet werden, um die Verwendung der Benennungskonvention zu vereinfachen.

Konstante	Wert
wszCERTEXITMODULE_POSTFIX	TEXT(". Beenden")

 

Es kann nicht mehr als ein Visual Basic Scripting Edition-Exitmodul gleichzeitig auf dem Certificate Services-Server registriert werden. Wenn mehr als ein Visual Basic Scripting Edition-Exitmodul registriert ist, kann das MMC-Snap-In der Zertifizierungsstelle, die Zertifikatdiensteanwendung oder das Befehlszeilenprogramm certutil Zu Fehlern führen. Beachten Sie, dass die Visual Basic Scripting Edition-Entwicklungsumgebung eine DLL automatisch registriert, wenn sie erfolgreich erstellt wurde. Daher kann diese Situation auftreten, wenn ein Visual Basic Scripting Edition-Exitmodul bereits registriert ist und ein anderes Visual Basic Scripting Edition-Exitmodul erstellt wird. Um diese Situation zu vermeiden, müssen Sie die Registrierung eines der Exitmodule der Visual Basic Scripting Edition mithilfe der Befehlszeilenanweisung regsvr32 /u FileName.dllaufheben, wobei FileName.dll der Name des Visual Basic Scripting Edition-Exitmoduls ist, das nicht aktiviert werden soll.

Implementierer von ICertExit in Visual Basic Scripting Edition müssen ihr Projekt in folgendem Format benennen:

"MyApp"

Dabei ist MyApp ein Spezifizierer, der die Anwendung identifiziert; Darüber hinaus muss die Klasse, die ICertExit implementiert, den Namen "Exit" haben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certexit.h (certsrv.h einschließen)

Weitere Informationen

ICertServerExit

IDispatch