CRegKey::EnumKey

開いているレジストリ キーのサブキーを列挙します。

LONG EnumKey(
   DWORD iIndex,
   LPTSTR pszName,
   LPDWORD pnNameLength,
   FILETIME* pftLastWriteTime = NULL 
) throw( );

パラメーター

  • iIndex
    サブキーのインデックス。このパラメーターには、後続の最初の呼び出しでは、ゼロです。次にインクリメントする必要があります。

  • pszName
    サブキーの名前を受け取る終端の null 文字を含むバッファーへのポインター。サブキーの名前のみバッファー完全なキーの階層構造ではなくにコピーします。

  • pnNameLength
    pszName、パラメーターで指定された TCHAR で、バッファーのサイズを指定する変数へのポインター。このサイズは終端の null 文字を含める必要があります。メソッドから制御が戻るときに、pnNameLength が指す変数はバッファーに格納された文字数が含まれます。返される計算は終端の null 文字は含まれません。

  • pftLastWriteTime
    時間を列挙したサブキー受け取る変数へのポインターは最後に記述されています。

戻り値

メソッドが成功した場合は、ERROR_SUCCESS を返します。メソッドが失敗した場合、戻り値は WINERROR.H で定義されている以外のエラー コードです。

解説

サブキーを列挙するには、ゼロのインデックスとの CRegKey::EnumKey を呼び出します。ERROR_NO_MORE_ITEMS メソッドがを返すまで、インデックス値と繰り返しをインクリメントします。詳細については、Windows SDKの RegEnumKeyEx を参照してください。

必要条件

ヘッダー: atlbase.h

参照

関連項目

CRegKey クラス