ICertAdmin2::GetConfigEntry 方法 (certadm.h)
GetConfigEntry 方法检索证书颁发机构 (CA) 的配置信息。
语法
HRESULT GetConfigEntry(
[in] const BSTR strConfig,
[in] const BSTR strNodePath,
[in] const BSTR strEntryName,
[out] VARIANT *pvarEntry
);
参数
[in] strConfig
字符串值,表示 CA 的有效配置字符串,格式为 COMPUTERNAME\CANAME,其中 COMPUTERNAME 是证书服务服务器的网络名称,CANAME 是 CA 的公用名,如证书服务设置过程中输入。 有关配置字符串名称的信息,请参阅 ICertConfig。 此参数可以是空字符串,在这种情况下,函数检索不特定于 CA 的配置信息。 此参数不能为 NULL。
重要提示:更改配置字符串时,GetConfigEntry 不会清除内部缓存。 更改 CA 的配置字符串时,必须实例化新的 ICertAdmin 对象,并使用新的配置字符串再次调用此方法。
[in] strNodePath
表示配置信息的节点路径的字符串值。 此参数可以是空字符串,在这种情况下,函数从 strConfig 标识的路径中检索配置信息。 此参数不能为 NULL。
[in] strEntryName
表示正在检索其信息的条目的名称的字符串值。 此值可以是空字符串,在这种情况下,将检索所有条目名称。 此参数不能为 NULL。
[out] pvarEntry
指向接收所请求信息的 VARIANT 的指针。
返回值
C++
如果函数成功,则返回值S_OK。如果函数失败,则返回值为 指示错误的 HRESULT 。 有关常见错误代码的列表,请参阅 常见 HRESULT 值。
VB
返回值是一个 Variant 类型的值,表示检索到的配置信息。注解
配置信息存储在注册表中的以下路径下。
\ HKEY_LOCAL_MACHINE系统\CurrentControlSet\服务\CertSvc\配置\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]
其中 CASANITIZEDNAME 是 CA 的 清理名称 。 有关已清理的名称的详细信息,请参阅 ICertConfig2::GetConfig。要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | certadm.h (包括 Certsrv.h) |
Library | Certidl.lib |
DLL | Certadm.dll |