IEnumCERTVIEWROW：：Skip 方法 (certview.h)

项目
08/22/2023

Skip 方法跳过行枚举序列中的指定行数。

语法

HRESULT Skip(
  [in] LONG celt
);

参数

[in] celt

要跳过的行数。 celt 参数的正值会导致行枚举序列在枚举序列中向前跳过。 celt 参数的负值会导致行枚举序列在枚举序列中向后跳过。

返回值

VB

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

返回值为 E_INVALIDARG 表示 celt 参数设置为负数，这会导致行枚举序列索引小于零。

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

备注

成功完成此方法后，调用 IEnumCERTVIEWROW：：Skip 方法以引用行枚举序列中的当前行。进行第二次调用后，可以使用以下接口的方法枚举与行中的证书关联的列、属性和扩展：

行枚举序列维护从零开始的内部索引。调用 Skip 方法会导致此索引根据 celt 参数的设置增加或减少。

如果 celt 参数的负值导致索引小于零，则后续调用 Next 的行为是未定义的。

如果 celt 参数的正值导致索引超过枚举序列中的最后一行，则后续对 Next 方法的调用将失败。

示例

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
HRESULT  hr;
LONG     Index;
// Reposition the row enumerator to the beginning of the rows.
hr = pEnumRow->Reset();
if (FAILED(hr))
{
    printf("Unable to reset pEnumRow\n");
    goto error;
}
// Skip some rows.
hr = pEnumRow->Skip(5);
if (FAILED(hr))
{
    printf("Unable to skip rows\n");
    goto error;
}

// Get the next row.
hr = pEnumRow->Next(&Index);
if (S_OK == hr)
{
    // Use this row as needed.
}

error:

if (NULL != pEnumRow)
    pEnumRow->Release();

要求


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