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

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

構文

HRESULT Skip(
  [in] LONG celt
);

パラメーター

[in] celt

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

戻り値

VB

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

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

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

注釈

この関数が正常に完了したら、 IEnumCERTVIEWCOLUMN::Next メソッドを呼び出して、列列挙シーケンス内の現在の列を参照します。 この 2 回目の呼び出しが行われた後、列内の情報を取得するには、次のいずれかのメソッドを呼び出します。

列列挙シーケンスは、内部の 0 から始まるインデックスを保持します。 Skip メソッドを呼び出すと、celt パラメーターの設定に基づいて、このインデックスが増減します。

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

こちらもご覧ください

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWCOLUMN::Reset

IEnumCERTVIEWCOLUMN:Next