Метод ICertManageModule::Configure (certmod.h)

Статья
08/22/2023

Метод Configure отображает пользовательский интерфейс модуля.

Синтаксис

HRESULT Configure(
  [in] const BSTR strConfig,
  [in] BSTR       strStorageLocation,
  [in] LONG       Flags
);

Параметры

[in] strConfig

Представляет строку конфигурации для сервера служб сертификатов в формате COMPUTERNAME\CANAME, где COMPUTERNAME — сетевое имя сервера служб сертификации, а CANAME — общее имя центра сертификации (ЦС), введенное для ЦС во время установки служб сертификации. Сведения об имени строки конфигурации см. в разделе ICertConfig.

[in] strStorageLocation

Расположение, которое предоставляет хранилище для значений свойств, как описано в определении strStorageLocation в ICertManageModule::GetProperty.

[in] Flags

Значение, используемое для определения того, должен ли интерфейс конфигурации быть представлен пользователю. Если это значение равно нулю, пользователю будет предоставлен интерфейс для настройки модуля. Если это значение равно CMM_REFRESHONLY, службы сертификатов не будут отображать пользовательский интерфейс, но последние изменения в конфигурации модуля будут действовать при обработке будущих запросов сертификатов (это позволяет включать изменения без необходимости ответа на пользовательский интерфейс).

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

VB

Если метод выполнен успешно, метод возвращает S_OK.

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

Метод Configure отображает пользовательский интерфейс модуля (если он существует), который позволяет пользователю просматривать и изменять настраиваемые элементы модуля. Модуль, реализующий ICertManageModule , может вызывать метод Configure , если активна страница свойств диспетчера служб сертификатов или выход из модуля и пользователь нажимает кнопку Настроить . Диспетчер служб сертификатов передаст в этот модуль расположение, на который ссылается strStorageLocation , и реализация этого метода сможет использовать это расположение по мере необходимости. Обратите внимание, что модуль может не содержать настраиваемых элементов (следовательно, пользовательский интерфейс не потребуется), но реализация этого метода по-прежнему необходима. Приведенный ниже пример не позволяет пользователю вносить изменения в конфигурацию, но реализует этот метод.

Примеры

#include <windows.h>
#include <Certmod.h>

HRESULT CCertManagePolicyModule::Configure( 
            /* [in] */ const BSTR strConfig,
            /* [in] */ BSTR strStorageLocation,
            /* [in] */ LONG Flags)
{
    if ( CMM_REFRESHONLY != Flags )
        MessageBox(NULL,
                   L"This module has no configurable items",
                   L"MyModule",
                   (MB_OK|MB_ICONINFORMATION));

    return S_OK;
}

Требования

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

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

ICertConfig

ICertManageModule

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