IEnumCERTVIEWROW::Next メソッド (certview.h)

[アーティクル]
02/26/2024

Next メソッドは、行列挙シーケンスの次の行に移動します。

構文

HRESULT Next(
  [out] LONG *pIndex
);

パラメーター

[out] pIndex

参照されている次の行のインデックス値を含む変数へのポインター。列挙する行がこれ以上ない場合、この変数は –1 に設定されます。 pIndex が NULL の場合、このメソッドは失敗します。

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返し、次の行は行列挙シーケンスによって参照されるようになりました。列挙する行がこれ以上ない場合は、S_FALSEが返され、 pIndex は -1 の値に設定されます。

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

VB

戻り値は、行列挙シーケンスによって参照されている行のインデックス値です。列挙する行がこれ以上ない場合、戻り値は –1 になります。

注釈

このメソッドが正常に完了すると、行の証明書に関連付けられている列、属性、拡張機能を、次のインターフェイスのメソッドを使用して列挙できます。

列挙シーケンス内のすべての行をループ処理すると、関連するクエリとシーケンスのサイズに応じて、リソースを大量に消費して計算を行うことができます。

例

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG  Index;
LONG  nCount;

// Ensure enumerator is at first row.
if (FAILED(pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // Count the database records by enumerating the rows.
    while (S_OK == pEnumRow->Next(&Index))
        nCount++;
    // Display number of records.
    printf("Number of records is %d\n", nCount);
}

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	certview.h (Certsrv.h を含む)
Library	Certidl.lib
[DLL]	Certadm.dll