IEnumCERTVIEWROW：：Next 方法 (certview.h)

项目
02/26/2024

Next 方法将移动到行枚举序列中的下一行。

语法

HRESULT Next(
  [out] LONG *pIndex
);

参数

[out] pIndex

指向变量的指针，该变量包含所引用的下一行的索引值。如果没有其他要枚举的行，则此变量将设置为 –1。如果 pIndex 为 NULL，此方法将失败。

返回值

C++

如果方法成功，该方法将返回S_OK，并且行枚举序列现在正在引用下一行。如果没有更多要枚举的行，则返回S_FALSE，并将 pIndex 设置为 –1 的值。

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

VB

返回值是行枚举序列现在引用的行的索引值。如果没有其他要枚举的行，则返回值为 –1。

注解

成功完成此方法后，可以使用以下接口的方法枚举与行中的证书关联的列、属性和扩展：

循环访问枚举序列中的所有行可能需要大量资源进行计算，具体取决于所涉及的查询和序列的大小。

示例

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG  Index;
LONG  nCount;

// Ensure enumerator is at first row.
if (FAILED(pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // Count the database records by enumerating the rows.
    while (S_OK == pEnumRow->Next(&Index))
        nCount++;
    // Display number of records.
    printf("Number of records is %d\n", nCount);
}

要求

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