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

Artículo
01/10/2024

El motor de servidor llama al método Initialize cuando se inicializa.

La llamada al método Initialize del módulo de salida permite que el módulo de salida realice la inicialización e informe al motor del servidor de los tipos de eventos de los que desea recibir una notificación.

Sintaxis

HRESULT Initialize(
  [in]          const BSTR strConfig,
  [out, retval] LONG       *pEventMask
);

Parámetros

[in] strConfig

Representa el nombre de la entidad de certificación, tal como se escribió durante la configuración de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig2.

[out, retval] pEventMask

Puntero al valor que representa los eventos para los que el módulo de salida solicita la notificación. Puede ser uno o varios de los valores siguientes.

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

Valor devuelto

C++

Si el método se ejecuta correctamente, el método devuelve S_OK y *pEventMask se establece en una combinación de las marcas de la tabla siguiente (o EXITEVENT_INVALID si el módulo de salida no desea recibir ninguna notificación de ningún evento).

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.

Si el módulo de salida no desea recibir una notificación de ningún evento, se debe establecer la marca EXITEVENT_INVALID.

VB

El valor devuelto es una máscara que contiene marcas que indican los eventos para los que el módulo de salida solicita notificación. Después de la llamada, el motor del servidor indicará todos los eventos de esos tipos al módulo de salida a través de una llamada a Notify. Se pueden establecer cualquiera o todas las marcas siguientes.

Código o valor devuelto	Descripción
EXITEVENT_CERTDENIED &H4	Certificado denegado.
EXITEVENT_CERTISSUED &H1	Certificado emitido.
EXITEVENT_CERTPENDING &H2	Certificado pendiente.
EXITEVENT_CERTRETRIEVEPENDING &H10	Llamada correcta a RetrievePending.
EXITEVENT_CERTREVOKED &H8	Certificado revocado.
EXITEVENT_CRLISSUED &H20	Lista de revocación de certificados emitida.
EXITEVENT_INVALID 0	El evento no es válido actualmente.
EXITEVENT_SHUTDOWN &H40	Apagado de Servicios de certificados.

Comentarios

Al escribir un módulo de salida personalizado, implemente este método.

Ejemplos

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

STDMETHODIMP CCertExit::Initialize(
    /* [in] */ BSTR const strConfig,
    /* [retval][out] */ LONG __RPC_FAR *pEventMask)
{
    // Verify valid pointer passed in.
    if (NULL == pEventMask)
        return ( E_POINTER );  // Bad pointer

    // strConfig can be used by the Exit module.
    // Here, it is stored in a BSTR member variable.
    // Remember to call SysFreeString to free m_strConfig when done.
    m_strConfig = SysAllocString( strConfig );
    // Check to determine whether there was enough memory.
    if (NULL == m_strConfig)
        return ( E_OUTOFMEMORY );  // Not enough memory

    // Inform server engine (CA) that we're interested in
    // the following events.
    *pEventMask = EXITEVENT_CERTISSUED |
                  EXITEVENT_CERTPENDING |
                  EXITEVENT_CERTDENIED |
                  EXITEVENT_CERTREVOKED |
                  EXITEVENT_CERTRETRIEVEPENDING |
                  EXITEVENT_CRLISSUED |
                  EXITEVENT_SHUTDOWN;

    if ( fDebug )
    {
        printf("Exit's Initialize member called\n");
        printf("\tstrConfig = %ws\n", strConfig );
    }

    return( S_OK );
}

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)