ICertExit-Schnittstelle (certexit.h)
Die ICertExit-Schnittstelle stellt die Kommunikation zwischen dem Zertifikatdiensteserver und einem Exitmodul bereit.
- 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) |