Метод IOCSPAdmin::GetConfiguration (certadm.h)

Статья
08/22/2023

Метод GetConfiguration подключается к серверу-ответчику протокола OCSP и инициализирует объект OCSPAdmin с помощью сведений о конфигурации с сервера.

Синтаксис

HRESULT GetConfiguration(
  [in] const BSTR   bstrServerName,
  [in] VARIANT_BOOL bForce
);

Параметры

[in] bstrServerName

Строка, содержащая имя сервера ответчика.

[in] bForce

C++	VARIANT_TRUE , если вызывающий объект хочет прочитать конфигурацию ответчика из реестра сервера, когда не удается найти запущенный экземпляр службы ответчика OCSP; в противном случае VARIANT_FALSE.
VB	Значение true , если вызывающий объект хочет прочитать конфигурацию ответчика из реестра сервера, когда не удается найти запущенный экземпляр службы ответчика OCSP; в противном случае — False.

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

VB

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

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

Если метод возвращает HRESULT_FROM_WIN32(ERROR_INVALID_STATE), конфигурация уже инициализирована.

Если метод возвращает E_INVALIDARG, параметру pVal присвоено значение NULL.

Служба ответчика OCSP на целевом сервере	bForceVARIANT_TRUE	bForceVARIANT_FALSE
Запущен	Получение конфигурации из службы.	Получение конфигурации из службы.
Остановлена	Попытайтесь получить конфигурацию из реестра сервера. Если эта попытка завершается неудачно, возвращается сообщение об ошибке.	Возвращает ошибку.

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

Служба ответчика OCSP на целевом сервере	BForce имеет значение True	BForce имеет значение False.
Запущен	Получение конфигурации из службы.	Получение конфигурации из службы.
Остановлена	Попытайтесь получить конфигурацию из реестра сервера. Если эта попытка завершается неудачно, возвращается сообщение об ошибке.	Возвращает ошибку.

Этот метод пытается считывать конфигурацию из работающего экземпляра службы ответчика OCSP, но это может оказаться невозможным, если служба не запущена или находится в недоступном состоянии. Вызывающий объект может указать методу считывать конфигурацию из реестра сервера, если не удается найти работающий экземпляр.

Метод завершается ошибкой, если вы пытаетесь вызвать его несколько раз для заданного объекта OCSPAdmin . Каждый экземпляр OCSPAdmin соответствует одному серверу ответчика. Чтобы подключиться к другому серверу в массиве серверов-ответчиков OCSP, создайте новый экземпляр объекта OCSPAdmin .

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008 Datacenter, Windows Server 2008 Корпоративная [только классические приложения]
Целевая платформа	Windows
Header	certadm.h (включая Certsrv.h)
Библиотека	Certadm.lib
DLL	Certadm.dll

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

IOCSPAdmin

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