IEnumCERTVIEWEXTENSION：：Skip 方法 (certview.h)

發行項
03/13/2024

Skip 方法會略過延伸模組列舉序列中的指定延伸模塊數目。

語法

HRESULT Skip(
  [in] LONG celt
);

參數

[in] celt

要略過的擴充功能數目。 celt 參數的正值會導致延伸列舉序列在序列中向前略過。 celt 參數的負值會導致延伸列舉序列在序列中向後略過。

傳回值

VB

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

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

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

備註

成功完成這個方法之後，請呼叫 IEnumCERTVIEWEXTENSION：：Next 方法，以參考擴充列舉序列中的目前延伸模組。延伸模組名稱、旗標和值可以透過下列方法來存取：

擴充列舉序列會維護內部以零起始的索引。 Skip 方法的呼叫會導致這個索引增加或減少 celt 參數中指定的延伸模塊數目。

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

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

範例

HRESULT  hr;
LONG     Index;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
// skip the next 5 extensions
hr = pEnumExt->Skip(5);
if (S_OK == hr)
{
    // get the next extension
    hr = pEnumExt->Next(&Index);
    if (S_OK == hr)
    {
        // Use this extension as needed.
    }
}

規格需求

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