ICertRequest2：：GetCAProperty 方法 (certcli.h)

  • 项目

GetCAProperty 方法检索证书颁发机构 (CA) 的属性值。 此方法的功能与 ICertAdmin2：：GetCAProperty 相同。 有关此方法的信息，请参阅 ICertAdmin2：：GetCAProperty。

语法

HRESULT GetCAProperty(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [in]          LONG       PropIndex,
  [in]          LONG       PropType,
  [in]          LONG       Flags,
  [out, retval] VARIANT    *pvarPropertyValue
);

参数

[in] strConfig

表示 CA 的有效配置字符串，格式为 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是证书服务服务器的网络名称，CANAME 是 CA 的公用名，如证书服务设置期间输入。 有关配置字符串名称的信息，请参阅 ICertConfig。

[in] PropId

指定属性标识符。 有关此参数的信息，请参阅 ICertAdmin2：：GetCAProperty 中的表。

[in] PropIndex

如果 为 PropId 编制索引，则为检索属性值时要使用的从零开始的索引。 如果未为 PropId 编制索引，则忽略此值。

[in] PropType

指定属性的类型，该属性对应于 PropId 表中的 Type 列。 类型可以是以下类型之一。

值 含义
PROPTYPE_LONG
 有符号的长数据
PROPTYPE_DATE
 保留 (供将来使用的日期/时间)
PROPTYPE_BINARY
 Binary data
PROPTYPE_STRING
 Unicode 字符串数据

[in] Flags

以下标志可用于指定返回的属性值的格式：这些标志仅对二进制数据 (（如证书、证书链或 证书吊销列表 ）) 有意义，否则将被忽略。

值 含义
CV_OUT_BASE64
 不带 BEGIN/END 的 BASE64
CV_OUT_BASE64HEADER
 具有 BEGIN 证书和 END CERTIFICATE 的 BASE64
CV_OUT_BASE64REQUESTHEADER
 具有 BEGIN 新证书请求和结束新证书请求的 BASE64
CV_OUT_BASE64X509CRLHEADER
 BASE64 与 BEGIN X509 CRL 和 END X509 CRL
CV_OUT_BINARY
 二进制
CV_OUT_HEX
 十六进制字符串
CV_OUT_HEXADDR
 具有地址/偏移量的十六进制字符串
CV_OUT_HEXASCII
 具有 ASCII 的十六进制字符串
CV_OUT_HEXASCIIADDR
 具有 ASCII 和地址/偏移量的十六进制字符串

[out, retval] pvarPropertyValue

指向接收请求的属性值的 VARIANT 的指针。

使用完 VARIANT 后，通过调用 VariantClear 函数来释放它。

返回值

C++

如果方法成功，该方法将返回S_OK。

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

VB

返回值是接收请求的属性值的 Variant 。

要求

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

另请参阅

CCertRequest

ICertRequest

ICertRequest2