Поделиться через

Метод ICertExit::Initialize (certexit.h)

  • Статья

Метод Initialize вызывается подсистемой сервера при его инициализации.

Вызов метода Initialize модуля выхода позволяет модульу выхода выполнить инициализацию и сообщить подсистеме сервера, о каких типах событий он хотел бы получать уведомления.

Синтаксис

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

Параметры

[in] strConfig

Представляет имя центра сертификации, указанное во время настройки служб сертификации. Дополнительные сведения об имени строки конфигурации см. в разделе ICertConfig2.

[out, retval] pEventMask

Указатель на значение , представляющее события, для которых модуль выхода запрашивает уведомление. Это может быть одно или несколько из следующих значений.

Значение Значение
EXITEVENT_CERTDENIED
 Сертификат отклонен.
EXITEVENT_CERTISSUED
 Выданный сертификат.
EXITEVENT_CERTPENDING
 Ожидается сертификат.
EXITEVENT_CERTRETRIEVEPENDING
 Успешный вызов Метода RetrievePending.
EXITEVENT_CERTREVOKED
 Сертификат отозван.
EXITEVENT_CRLISSUED
 Выданный список отзыва сертификатов .
EXITEVENT_SHUTDOWN
 Завершение работы служб сертификатов.

Возвращаемое значение

C++

Если метод выполняется успешно, метод возвращает S_OK и для *pEventMask задано сочетание флагов в таблице ниже (или EXITEVENT_INVALID, если модуль выхода не хочет получать уведомления о каких-либо событиях).

Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Если модуль выхода не хочет получать уведомления о каких-либо событиях, необходимо установить флаг EXITEVENT_INVALID.

VB

Возвращаемое значение представляет собой маску, содержащую флаги, указывающие события, для которых модуль выхода запрашивает уведомление. После вызова все события этих типов будут сигнализироваться подсистемой сервера в модуль выхода через вызов Notify. Можно задать любой или все следующие флаги.
Возвращаемый код/значение Описание
EXITEVENT_CERTDENIED
&H4
 Сертификат отклонен.
EXITEVENT_CERTISSUED
&H1
 Выданный сертификат.
EXITEVENT_CERTPENDING
&H2
 Ожидается сертификат.
EXITEVENT_CERTRETRIEVEPENDING
&H10
 Успешный вызов Метода RetrievePending.
EXITEVENT_CERTREVOKED
&H8
 Сертификат отозван.
EXITEVENT_CRLISSUED
&H20
 Выданный список отзыва сертификатов .
EXITEVENT_INVALID
0
 В настоящее время событие недопустимо.
EXITEVENT_SHUTDOWN
&H40
 Завершение работы служб сертификатов.

Комментарии

При написании пользовательского модуля выхода реализуйте этот метод.

Примеры

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

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header certexit.h (включая Certsrv.h)

См. также раздел

ICertExit

ICertExit2

Уведомление