IEnumCERTVIEWEXTENSION::Skip メソッド (certview.h)

[アーティクル]
03/05/2024

Skip メソッドは、拡張列挙シーケンス内の指定された数の拡張機能をスキップします。

構文

HRESULT Skip(
  [in] LONG celt
);

パラメーター

[in] celt

スキップする拡張機能の数。 celt パラメーターに正の値を指定すると、拡張列挙シーケンスがシーケンス内でスキップされます。 celt パラメーターに負の値を指定すると、拡張列挙シーケンスがシーケンス内で後方にスキップされます。

戻り値

VB

メソッドが成功した場合、メソッドは S_OKを返します。

E_INVALIDARGの戻り値は、 celt パラメーターの負の値が原因で拡張列挙シーケンスインデックスが 0 未満になったことを示します。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、「共通の HRESULT 値」を参照してください。

注釈

このメソッドが正常に完了したら、 IEnumCERTVIEWEXTENSION::Next メソッドを呼び出して、拡張列挙シーケンス内の現在の拡張機能を参照します。拡張機能の名前、フラグ、および値には、次のメソッドを使用してアクセスできます。

拡張列挙シーケンスは、内部の 0 から始まるインデックスを保持します。 Skip メソッドを呼び出すと、このインデックスは celt パラメーターで指定された拡張機能の数だけ増減します。

celt パラメーターの負の値を指定すると、インデックスが 0 未満になると、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 を含む)
Library	Certidl.lib
[DLL]	Certadm.dll