ICEnroll4::enumPendingRequest 方法 (xenroll.h)
[此方法在 Windows Server 2008 和 Windows Vista 中不再可用。]
enumPendingRequest 方法枚举挂起的证书请求,并从每个请求中检索指定的属性。
此方法首先在 ICEnroll4 接口中定义。
语法
HRESULT enumPendingRequest(
[in] LONG lIndex,
[in] LONG lDesiredProperty,
[out] VARIANT *pvarProperty
);
参数
[in] lIndex
指定将检索其属性的挂起请求的序号位置。 为第一个请求指定零。
[in] lDesiredProperty
要检索的属性的标识符。 此参数的取值可为下列值之一:
值 | 含义 |
---|---|
|
证书颁发机构的 DNS 名称 (CA) 。 |
|
CA 的显示名称。 |
|
CA 的名称。 |
|
请求的哈希值。 |
|
证书请求 ID。 |
[out] pvarProperty
指向 VARIANT 的指针,该 变量 接收检索到的属性的值。
使用完 VARIANT 后,通过调用 VariantClear 函数来释放它。
返回值
C++
如果方法成功,该方法将返回S_OK。如果方法失败,它将返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 通用 HRESULT 值。
如果为 lDesiredProperty 指定了以下值,则此方法返回E_NOTIMPL:
- XEPR_DATE
- XEPR_V1TEMPLATENAME
- XEPR_V2TEMPLATEOID
- XEPR_VERSION
如果为 lDesiredProperty 指定任何其他值,此方法将返回E_INVALIDARG。
VB
返回一个 Variant 类型的 值,其中包含挂起请求中的属性。注解
将证书注册控件作为脚本控件执行时,将禁用此方法。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | xenroll.h |
Library | Uuid.lib |
DLL | Xenroll.dll |