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

  • Artículo

El motor del servidor llama al método Notify para notificar a un módulo de salida que se ha producido un evento.

Sintaxis

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

Parámetros

[in] ExitEvent

Máscara que indica el tipo de evento de salida que se ha producido. La máscara puede tener uno de los siguientes bits de marca establecidos.

Valor Significado
EXITEVENT_CERTISSUED
 Certificado emitido.
EXITEVENT_CERTPENDING
 Certificado pendiente.
EXITEVENT_CERTDENIED
 Certificado denegado.
EXITEVENT_CERTREVOKED
 Certificado revocado.
EXITEVENT_CERTRETRIEVEPENDING
 Llamada correcta a ICertRequest::RetrievePending.
EXITEVENT_CRLISSUED
 Lista de revocación de certificados (CRL) emitida.
EXITEVENT_SHUTDOWN
 Apagado de Servicios de certificados.

[in] Context

Especifica un identificador de contexto que se puede usar para obtener propiedades asociadas al evento desde la interfaz ICertServerExit .

Valor devuelto

VB

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Si una entidad de certificación usa varios módulos de salida, Servicios de certificados notificará a cada módulo de salida del evento (siempre que se solicite la notificación del módulo de salida mediante Initialize). No se debe asumir el orden en el que se notifican los módulos de salida, ni un módulo de salida depende del procesamiento de otro módulo de salida. Cada módulo de salida notificado debe volver de Notificar antes de que se notifique al siguiente módulo de salida.

Ejemplos

#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);
}

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certexit.h (incluya Certsrv.h)

Consulte también

ICertExit

ICertExit2