Interface ICertExit (certexit.h)
L’interface ICertExit fournit des communications entre le serveur des services de certificat et un module de sortie.
- Initialisez le serveur Des services de certificats.
- Informez le module de sortie d’un événement tel que l’émission de certificat, l’émission de liste de révocation de certificats (CRL) ou l’arrêt du serveur.
- Récupérez une description du module de sortie.
ICertExit est défini dans Certexit.h. Toutefois, lorsque vous créez votre programme, utilisez Certsrv.h comme fichier include.
Les interfaces des services de certificats prennent en charge à la fois les modèles de thread d’appartement et de thread libre. Pour un meilleur débit, le threading gratuit est recommandé.
Héritage
L’interface ICertExit hérite de l’interface IDispatch . ICertExit possède également les types de membres suivants :
Méthodes
L’interface ICertExit a ces méthodes.
| ICertExit ::GetDescription Retourne une description lisible par l’utilisateur du module de sortie et de sa fonction. |
| ICertExit ::Initialize Appelé par le moteur du serveur lorsqu’il s’initialise lui-même. |
| ICertExit ::Notify Appelé par le moteur de serveur pour notifier un module de sortie qu’un événement s’est produit. |
Remarques
Les implémenteurs d’ICertExit doivent également implémenter ICertManageModule. En outre, le ProgID d’une classe implémentant ICertExit doit être conforme à une convention de nommage. Plus précisément, le ProgID doit être de la forme suivante :
« MyApp. Quitter »
Où MyApp est un spécificateur qui identifie l’application. Par exemple, en C++, le code suivant peut être utilisé dans la macro DECLARE_REGISTRY d’une classe (CMyCertExitModule) qui implémente ICertExit.
DECLARE_REGISTRY(
CMyCertExitModule,
L"MyCode.Exit.1",
L"MyCode.Exit",
IDS_CERTEXITMODULE_DESC,
THREADFLAGS_BOTH)
Pour l’exemple précédent, la valeur IDS_CERTEXITMODULE_DESC est un identificateur spécifique à l’application dans le fichier de ressources (.rc) pour une chaîne qui décrit la classe.
Les constantes de chaîne définies dans Certmod.h peuvent être utilisées pour simplifier le respect de la convention de nommage.
| Constant | Valeur |
|---|---|
| wszCERTEXITMODULE_POSTFIX | TEXT(« . Quitter ») |
Il est possible d’inscrire plusieurs modules de sortie de Visual Basic Scripting Edition sur le serveur des services de certificat à la fois. Si plusieurs modules de sortie de Visual Basic Scripting Edition sont inscrits, le composant logiciel enfichable MMC de l’autorité de certification, l’application Certificate Services ou le programme de ligne de commande certutil peut produire des erreurs. Notez que l’environnement de développement Visual Basic Scripting Edition inscrit automatiquement une DLL lorsqu’elle est générée. Par conséquent, vous pouvez rencontrer cette situation lorsqu’un module de sortie Visual Basic Scripting Edition est déjà inscrit et qu’un autre module de sortie Visual Basic Scripting Edition est créé. Pour éviter cette situation, vous devez annuler l’inscription de l’un des modules de sortie Visual Basic Scripting Edition, au moyen de l’instruction de ligne de commande regsvr32 /u FileName.dll, où FileName.dll est le nom du module de sortie Visual Basic Scripting Edition qui n’est pas destiné à être activé.
Les implémenteurs d’ICertExit dans Visual Basic Scripting Edition doivent nommer leur projet au format :
«MyApp»
Où MyApp est un spécificateur qui identifie l’application ; en outre, la classe implémentant ICertExit doit être nommée « Exit ».
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | certexit.h (include Certsrv.h) |