通过

IOCSPAdmin：：GetConfiguration 方法 (certadm.h)

  • 项目

GetConfiguration 方法连接到联机证书状态协议 (OCSP) 响应方服务器，并使用来自服务器的配置信息初始化 OCSPAdmin 对象。

语法

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

参数

[in] bstrServerName

包含响应者服务器名称的字符串。

[in] bForce

C++ VARIANT_TRUE 当找不到正在运行的 OCSP 响应程序服务实例时，调用方想要从服务器的注册表读取响应方配置;否则， VARIANT_FALSE。
VB 如果在找不到正在运行的 OCSP 响应程序服务实例时，调用方想要从服务器的注册表读取响应方配置，则其值为 True;否则为 False。

返回值

VB

如果方法成功，则返回 S_OK。

如果方法失败，它将返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表，请参阅 通用 HRESULT 值。

如果 方法返回 HRESULT_FROM_WIN32 (ERROR_INVALID_STATE) ，则配置已初始化。

如果方法返回 E_INVALIDARG，则 pVal 参数设置为 NULL。

注解

下表列出了 bForce 参数值对方法调用的影响。

目标服务器上的 OCSP 响应程序服务 bForce 已 VARIANT_TRUE bForce 已 VARIANT_FALSE
正在运行 从服务中检索配置。 从服务中检索配置。
已停止 尝试从服务器注册表检索配置。 如果此尝试失败，则返回错误。 返回错误。
 

下表列出了 bForce 参数值对方法调用的影响。

目标服务器上的 OCSP 响应程序服务 bForce 为 True bForce 为 False
正在运行 从服务中检索配置。 从服务中检索配置。
已停止 尝试从服务器注册表检索配置。 如果此尝试失败，则返回错误。 返回错误。
 

此方法尝试从正在运行的 OCSP 响应程序服务实例读取配置，但如果服务未运行或处于不可访问状态，则可能无法执行此操作。 如果找不到正在运行的实例，调用方可以指示 方法从服务器的注册表读取配置。

如果尝试为给定 的 OCSPAdmin 对象多次调用该方法，则该方法失败。 OCSPAdmin 的每个实例对应于一个响应方服务器。 若要连接到 OCSP 响应服务器数组中的另一个服务器，请创建 OCSPAdmin 对象的新实例。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 Datacenter、Windows Server 2008 企业版 [仅限桌面应用]
目标平台 Windows
标头 certadm.h (包括 Certsrv.h)
Library Certadm.lib
DLL Certadm.dll

另请参阅

IOCSPAdmin