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)
程式庫	Certidl.lib
Dll	Certadm.dll

另請參閱

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWCOLUMN：：Reset

IEnumCERTVIEWCOLUMN：Next