IEnumCERTVIEWATTRIBUTE：：Skip 方法 (certview.h)

  • 發行項

Skip 方法會略過屬性列舉序列中的指定屬性數目。

語法

HRESULT Skip(
  [in] LONG celt
);

參數

[in] celt

要略過的屬性數目。 celt 參數的正值會導致屬性列舉序列在序列中向前略過。 celt 參數的負值會導致屬性列舉序列在序列中向後略過。

傳回值

VB

如果方法成功，方法會傳回S_OK。

E_INVALIDARG傳回值表示 celt 參數的負值導致屬性列舉順序索引變成小於零。

如果方法失敗，它會傳回指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

備註

成功完成此方法時，呼叫 IEnumCERTVIEWATTRIBUTE：：Next 方法，以參考屬性列舉序列中的目前屬性。 您可以透過下列方法來存取屬性名稱和值：

屬性列舉序列會維護內部以零起始的索引。 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)
程式庫 Certidl.lib
Dll Certadm.dll

另請參閱

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWATTRIBUTE：：Reset

IEnumCERTVIEWATTRIBUTE：Next