前のトピック: regGetKeyValues -- レジストリ キーの値情報を取得する(関数)次のトピック: regGetVal -- レジストリの値を取得する(関数)


regGetSubKey -- レジストリ キーのサブ キーを取得する(関数)

regGetSubKeys 関数は、ローカル システムまたはリモート システムの指定されたレジストリ キーのサブ キーを配列で返します。 デフォルトでは、直接のサブキーのみが返されます。 オプションで、すべてのサブキーを再帰的に取得できます。

この関数の構文は以下のとおりです。

regGetSubKeys(sKey, fRecurse)
sKey

レジストリ キーを指定します。

, fRecurse

入れ子のサブキーを取得します。

この関数は、sKey のサブキーの名前を保持する配列を返します。 個々のサブキー名が sKey から開始される相対パスとして返されます。 返された配列を regCreateSubKeys() に渡し、システム間でサブキー ツリーをコピーできます。

この関数が失敗すると、例外が発生します。

HKLM¥Software¥CA のサブキーを取得します(エラー処理を行います)。

try {
    var arr, i, l;
    arr = regGetSubKeys("HKLM¥¥Software¥¥CA");
    l = arr.length;
    for(i=0; i < l; i++)
    {
        ? arr[i]
    }
}
catch(e) {
    ? "Failure:", e
}

再帰的に HKLM¥Software¥CA のサブキーをすべて取得します。

arr = regGetSubKeys("HKLM¥¥Software¥¥CA", true);
l = arr.length;
for(i=0; i < l; i++)
{
    ? arr[i]
}

リモート システム client8 からサブキー ツリーを取得し、それをリモート システム client9 に適用します。

arr = regGetSubKeys("client8::HKLM¥¥Software¥¥ACME", true);
regSetSubKeys("client9::HKLM¥¥Software¥¥ACME", arr);

注: キーの値は個別に処理する必要があります。

関連項目

regCreateKey -- レジストリ キーを作成する(関数)

regCreateSubkeys -- 配列からサブキーを作成する(関数)