IEnumCERTVIEWCOLUMN：：Skip 方法 (certview.h)

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

语法

HRESULT Skip(
  [in] LONG celt
);

参数

[in] celt

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

返回值

VB

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

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

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

注解

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

• IEnumCERTVIEWCOLUMN：：GetName：检索列的非本地化名称。
• IEnumCERTVIEWCOLUMN：：GetDisplayName：检索列的本地化名称。
• IEnumCERTVIEWCOLUMN：：GetValue：检索列中的数据。
• IEnumCERTVIEWCOLUMN：：GetType：检索列中的数据类型。
• IEnumCERTVIEWCOLUMN：：GetMaxLength：检索列的最大长度（以字节为单位）。

列枚举序列维护从零开始的内部索引。 调用 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