ICertExit::Initialize-Methode (certexit.h)

Artikel
02/26/2024

Die Initialize-Methode wird von der Server-Engine aufgerufen, wenn sie sich selbst initialisiert.

Der Aufruf der Initialize-Methode des Exitmoduls ermöglicht es dem Exitmodul, eine Initialisierung durchzuführen und die Server-Engine darüber zu informieren, über welche Arten von Ereignissen es benachrichtigt werden soll.

Syntax

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

Parameter

[in] strConfig

Stellt den Namen der Zertifizierungsstelle dar, wie er während der Einrichtung von Zertifikatdiensten eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig2.

[out, retval] pEventMask

Ein Zeiger auf den Wert, der die Ereignisse darstellt, für die das Beendigungsmodul eine Benachrichtigung anfordert. Dies kann mindestens einer der folgenden Werte sein.

Wert	Bedeutung
EXITEVENT_CERTDENIED	Zertifikat verweigert.
EXITEVENT_CERTISSUED	Zertifikat ausgestellt.
EXITEVENT_CERTPENDING	Zertifikat ausstehend.
EXITEVENT_CERTRETRIEVEPENDING	Erfolgreicher Aufruf von RetrievePending.
EXITEVENT_CERTREVOKED	Zertifikat widerrufen.
EXITEVENT_CRLISSUED	Zertifikatsperrliste ausgestellt.
EXITEVENT_SHUTDOWN	Herunterfahren von Zertifikatdiensten.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und *pEventMask wird auf eine Kombination der Flags in der folgenden Tabelle festgelegt (oder EXITEVENT_INVALID, wenn das Exitmodul nicht über Ereignisse benachrichtigt werden möchte).

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Wenn das Beendigungsmodul nicht über Ereignisse benachrichtigt werden möchte, sollte das Flag EXITEVENT_INVALID festgelegt werden.

VB

Der Rückgabewert ist eine Maske, die Flags enthält, die die Ereignisse angeben, für die das Beendigungsmodul eine Benachrichtigung anfordert. Nach dem Aufruf werden alle Ereignisse dieser Typen von der Server-Engine an das Beendigungsmodul durch einen Aufruf von Notify signalisiert. Es können beliebige oder alle der folgenden Flags festgelegt werden.

Rückgabecode/-wert	BESCHREIBUNG
EXITEVENT_CERTDENIED &H4	Zertifikat verweigert.
EXITEVENT_CERTISSUED &H1	Zertifikat ausgestellt.
EXITEVENT_CERTPENDING &H2	Zertifikat ausstehend.
EXITEVENT_CERTRETRIEVEPENDING &H10	Erfolgreicher Aufruf von RetrievePending.
EXITEVENT_CERTREVOKED &H8	Zertifikat widerrufen.
EXITEVENT_CRLISSUED &H20	Zertifikatsperrliste ausgestellt.
EXITEVENT_INVALID 0	Das Ereignis ist derzeit ungültig.
EXITEVENT_SHUTDOWN &H40	Herunterfahren von Zertifikatdiensten.

Hinweise

Wenn Sie ein benutzerdefiniertes Exitmodul schreiben, implementieren Sie diese Methode.

Beispiele

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

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 (include Certsrv.h)