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

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

構文

HRESULT Next(
  [out] LONG *pIndex
);

パラメーター

[out] pIndex

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

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返し、次の拡張機能が参照されるようになりました。 拡張機能がこれ以上ない場合は、S_FALSEが返され、 pIndex パラメーターの値は –1 に設定されます。

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

VB

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

解説

このメソッドが正常に完了すると、次のメソッドを使用して拡張名、フラグ、および値にアクセスできます。

• IEnumCERTVIEWEXTENSION::GetName
• IEnumCERTVIEWEXTENSION::GetFlags
• IEnumCERTVIEWEXTENSION::GetValue

例

LONG  Index;
LONG  nCount;

// determine the number of extensions
nCount = 0;
// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
while (S_OK == pEnumExt->Next(&Index))
{
    nCount++;
}
printf("Number of extensions is %d\n", nCount);

要件

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

関連項目

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWEXTENSION::GetFlags

IEnumCERTVIEWEXTENSION::GetName

IEnumCERTVIEWEXTENSION::GetValue