Метод IOCSPAdmin::SetConfiguration (certadm.h)
Метод SetConfiguration обновляет службу ответчика с изменениями конфигурации.
Синтаксис
HRESULT SetConfiguration(
[in] const BSTR bstrServerName,
[in] VARIANT_BOOL bForce
);
Параметры
[in] bstrServerName
Строка, содержащая имя службы ответчика.
[in] bForce
C++ | VARIANT_TRUE , если метод должен обновлять реестр служб ответчика, если служба находится в автономном режиме или недоступна; в противном случае VARIANT_FALSE. Если служба находится в автономном режиме или недоступна и параметр bForceVARIANT_TRUE, SetConfiguration обновляет реестр служб ответчиков напрямую. |
VB | Значение true , если метод должен обновлять реестр служб ответчика, когда служба находится в автономном режиме или недоступна; в противном случае — False. Если служба находится в автономном режиме или недоступна, а параметр bForce имеет значение True, SetConfiguration обновляет реестр служб ответчика напрямую. |
Возвращаемое значение
VB
Если метод завершается успешно, он возвращает S_OK.Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
Комментарии
В следующей таблице приведено влияние значения параметра bForce на вызов метода.
Служба ответчика OCSP на целевом сервере | bForceVARIANT_TRUE | bForceVARIANT_FALSE |
---|---|---|
Запущен | Получение конфигурации из службы. | Получение конфигурации из службы. |
Остановлена | Попытайтесь получить конфигурацию из реестра сервера. Если эта попытка завершается неудачно, возвращается сообщение об ошибке. | Возвращает ошибку. |
В следующей таблице приведено влияние значения параметра bForce на вызов метода.
Служба ответчика OCSP на целевом сервере | BForce имеет значение True | BForce имеет значение False. |
---|---|---|
Запущен | Получение конфигурации из службы. | Получение конфигурации из службы. |
Остановлена | Попытайтесь получить конфигурацию из реестра сервера. Если эта попытка завершается неудачно, возвращается сообщение об ошибке. | Возвращает ошибку. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Ни одна версия не поддерживается |
Минимальная версия сервера | Windows Server 2008 Datacenter, Windows Server 2008 Корпоративная [только классические приложения] |
Целевая платформа | Windows |
Header | certadm.h (включая Certsrv.h) |
Библиотека | Certadm.lib |
DLL | Certadm.dll |