IEnumCERTVIEWROW：：Skip 方法 (certview.h)

發行項
08/22/2023

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

語法

HRESULT Skip(
  [in] LONG celt
);

參數

[in] celt

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

傳回值

VB

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

E_INVALIDARG傳回值表示 celt 參數已設定為負數，導致資料列列舉序列索引變成小於零。

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

備註

成功完成這個方法之後，請呼叫 IEnumCERTVIEWROW：：Skip 方法來參考資料列列舉序列中的目前資料列。進行此第二次呼叫之後，可以使用下列介面的方法列舉與資料列中憑證相關聯的資料行、屬性和延伸模組：

資料列列舉序列會維護內部以零起始的索引。 Skip方法的呼叫會根據celt參數的設定來增加或減少這個索引。

如果 celt 參數的負值導致索引小於零，則後續呼叫 Next 的行為未定義。

如果 celt 參數的正值導致索引超過列舉序列中的最後一個資料列，則 Next 方法的後續呼叫將會失敗。

範例

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
HRESULT  hr;
LONG     Index;
// Reposition the row enumerator to the beginning of the rows.
hr = pEnumRow->Reset();
if (FAILED(hr))
{
    printf("Unable to reset pEnumRow\n");
    goto error;
}
// Skip some rows.
hr = pEnumRow->Skip(5);
if (FAILED(hr))
{
    printf("Unable to skip rows\n");
    goto error;
}

// Get the next row.
hr = pEnumRow->Next(&Index);
if (S_OK == hr)
{
    // Use this row as needed.
}

error:

if (NULL != pEnumRow)
    pEnumRow->Release();

規格需求


最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	certview.h (包含 Certsrv.h)
程式庫	Certidl.lib
Dll	Certadm.dll