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

要检索的属性的标识符。 此参数的取值可为下列值之一:

含义
XEPR_CADNS
证书颁发机构的 DNS 名称 (CA) 。
XEPR_CAFRIENDLYNAME
CA 的显示名称。
XEPR_CANAME
CA 的名称。
XEPR_HASH
请求的哈希值。
XEPR_REQUESTID
证书请求 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