Méthode ICertExit ::Notify (certexit.h)

Article
02/23/2024

La méthode Notify est appelée par le moteur de serveur pour notifier un module de sortie qu’un événement s’est produit.

Syntaxe

HRESULT Notify(
  [in] LONG ExitEvent,
  [in] LONG Context
);

Paramètres

[in] ExitEvent

Masque qui indique le type d’événement de sortie qui s’est produit. L’un des indicateurs-bits suivants peut être défini sur le masque.

Valeur	Signification
EXITEVENT_CERTISSUED	Certificat émis.
EXITEVENT_CERTPENDING	Certificat en attente.
EXITEVENT_CERTDENIED	Certificat refusé.
EXITEVENT_CERTREVOKED	Certificat révoqué.
EXITEVENT_CERTRETRIEVEPENDING	Appel réussi à ICertRequest ::RetrievePending.
EXITEVENT_CRLISSUED	Liste de révocation de certificats (CRL) émise.
EXITEVENT_SHUTDOWN	Arrêt des services de certificats.

[in] Context

Spécifie un handle de contexte qui peut être utilisé pour obtenir les propriétés associées à l’événement à partir de l’interface ICertServerExit .

Valeur retournée

VB

Si la méthode réussit, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Si une autorité de certification utilise plusieurs modules de sortie, les services de certificats notifient chaque module de sortie de l’événement (à condition que le module de sortie ait demandé une notification au moyen de l’initialisation). L’ordre dans lequel les modules de sortie sont notifiés ne doit pas être supposé, et un module de sortie ne doit pas dépendre du traitement d’un autre module de sortie. Chaque module de sortie notifié doit retourner à partir de Notify avant que le module de sortie suivant ne soit averti.

Exemples

#include <windows.h>
#include <stdio.h>
#include <Certexit.h>

STDMETHODIMP CCertExit::Notify(
    /* [in] */ LONG ExitEvent,
    /* [in] */ LONG Context)
{
    char *pszEvent;
    HRESULT hr = S_OK;

    switch (ExitEvent)
    {
    case EXITEVENT_CERTISSUED:
        //  Call application-specific function for issued certs.
        hr = MyEventCertIssued(Context);
        pszEvent = "certissued";
        break;

    case EXITEVENT_CERTPENDING:
        pszEvent = "certpending";
        break;

    case EXITEVENT_CERTDENIED:
        pszEvent = "certdenied";
        break;

    case EXITEVENT_CERTREVOKED:
        pszEvent = "certrevoked";
        break;

    case EXITEVENT_CERTRETRIEVEPENDING:
        pszEvent = "retrievepending";
        break;

    case EXITEVENT_CRLISSUED:
        pszEvent = "crlissued";
        break;

    case EXITEVENT_SHUTDOWN:
        //  Call application-specific function for shutdown.
        hr = MyEventShutdown();
        pszEvent = "shutdown";
        break;

    default:
        pszEvent = "Unexpected event";
        break;
    }

    if ( fDebug )
    {
        //  Display what took place.
        printf("Exit::Notify(%s=%x, context=%u) return=%x\n",
                      pszEvent,
                      ExitEvent,
                      Context,
                      hr);
    }

    return(hr);
}

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)

Voir aussi

ICertExit

ICertExit2

Partager via