IEnumCERTVIEWATTRIBUTE：：Skip 方法 (certview.h)

  • 项目

Skip 方法跳过特性枚举序列中的指定数目的属性。

语法

HRESULT Skip(
  [in] LONG celt
);

参数

[in] celt

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

返回值

VB

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

返回值 E_INVALIDARG 指示 celt 参数的负值导致属性枚举序列索引小于零。

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

注解

成功完成此方法后，调用 IEnumCERTVIEWATTRIBUTE：：Next 方法以引用 attribute-enumeration 序列中的当前属性。 可以通过以下方法访问属性名称和值：

特性枚举序列维护从零开始的内部索引。 调用 Skip 方法会导致此索引增加或减少 celt 参数中指定的属性数。

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

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

示例

HRESULT  hr;
LONG     Index;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
// skip the next 5 attributes
hr = pEnumAttr->Skip(5);
if (S_OK == hr)
{
    // get the next attribute
    hr = pEnumAttr->Next(&Index);
    if (S_OK == hr)
    {
        // Use this attribute as needed.
    }
}

要求

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

另请参阅

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWATTRIBUTE：：Reset

IEnumCERTVIEWATTRIBUTE：Next