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 回目の呼び出しが行われた後、列内の情報を取得するには、次のいずれかのメソッドを呼び出します。
- IEnumCERTVIEWCOLUMN::GetName: 列の割り当てられていない名前を取得します。
- IEnumCERTVIEWCOLUMN::GetDisplayName: 列のローカライズされた名前を取得します。
- IEnumCERTVIEWCOLUMN::GetValue: 列のデータを取得します。
- IEnumCERTVIEWCOLUMN::GetType: 列のデータ型を取得します。
- IEnumCERTVIEWCOLUMN::GetMaxLength: 列の最大長をバイト単位で取得します。
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 |