IEnumCERTVIEWCOLUMN::Skip 方法 (certview.h)

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

语法

HRESULT Skip(
  [in] LONG celt
);

参数

[in] celt

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

返回值

VB

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

返回值为 E_INVALIDARG 表示 celt 参数中的负值导致列枚举序列索引小于零。

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

注解

成功完成此函数后,调用 IEnumCERTVIEWCOLUMN::Next 方法以引用列枚举序列中的当前列。 进行第二次调用后,可以通过调用以下方法之一来获取列中的信息:

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

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

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

示例

HRESULT  hr;
LONG     Index;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
// skip the next five columns
hr = pEnumCol->Skip(5);
if (S_OK == hr) 
{
    // get the next column
    hr = pEnumCol->Next(&Index);
    if (S_OK == hr)
    {
        // Use this column as needed.
    }
}

要求

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

另请参阅

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWCOLUMN::Reset

IEnumCERTVIEWCOLUMN:Next