IEnumCERTVIEWROW::Next メソッド (certview.h)
Next メソッドは、行列挙シーケンスの次の行に移動します。
HRESULT Next(
[out] LONG *pIndex
);
[out] pIndex
参照されている次の行のインデックス値を含む変数へのポインター。 列挙する行がこれ以上ない場合、この変数は –1 に設定されます。 pIndex が NULL の場合、このメソッドは失敗します。
メソッドが成功した場合、メソッドは S_OKを返し、次の行は行列挙シーケンスによって参照されるようになりました。 列挙する行がこれ以上ない場合は、S_FALSEが返され、 pIndex は -1 の値に設定されます。メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。
戻り値は、行列挙シーケンスによって参照されている行のインデックス値です。 列挙する行がこれ以上ない場合、戻り値は –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 |