リファレンス ガイド › AutoShell › AutoShell コア リファレンス › AutoShell 関数 › regGetKeyValues -- レジストリ キーの値情報を取得する（関数）

regGetKeyValues -- レジストリ キーの値情報を取得する（関数）

regGetKeyValues 関数は、ローカルまたはリモート システムのキーの名前、実際の値、およびレジストリの値のタイプを持つ二次元配列を返します。 返された配列を regSetKeyValues() に渡し、システム間で値の設定をコピーすることができます。

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

regGetKeyValues(sKey)

sKey

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

この関数は二次元配列を返します。 トップレベルの各要素は、値の名前を表す文字列、設定のポリモーフィック値、および値タイプの整数を含む 3 つの要素のサブ配列を保持します。 レジストリの値のタイプによって戻り値のタイプが決まります。

• REG_DWORD 値は数値として返されます
• REG_SZ および REG_EXPAND_SZ は文字列として返されます
• REG_MULTI_SZ は文字列の配列として返されます
• REG_EXPAND_SZ の値は、現在の環境変数を使用してすでに展開されています
• REG_BINARY の値は AutoShell の CharArr オブジェクトとして返されます。これは、JavaScript 文字列変数がバイナリ データを正しく処理できないためです。

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

例

HKLM¥Software¥ACME¥Settings キーの値情報を取得して表示します。

arr = regGetKeyValues("HKLM¥¥Software¥¥ACME¥¥Settings");
    l = arr.length;
    for(i=0; i < l; i++)
    {
      ? "Name: ", arr[i][0]
      ? "Value:", arr[i][1]
      ?? "Type:  "
      switch(arr[i][2])
      {
        case REG_SZ:
          ? "REG_SZ"
          break;
        case REG_EXPAND_SZ:
          ? "REG_EXPAND_SZ"
          break;
        case REG_BINARY:
          ? "REG_BINARY"
          break;
        case REG_DWORD:
          ? "REG_DWORD"
          break;
        case REG_MULTI_SZ:
          ? "REG_MULTI_SZ"
          break;
        default:
          ? "Unknown"
      }
    }

リモート システム client8 から値を取得し、リモート システム client9 にその値を適用します。

arr = regGetKeyValues("client8::HKLM¥¥Software¥¥ACME¥¥Settings");
regSetKeyValues("client9::HKLM¥¥Software¥¥ACME¥¥Settings", arr);

関連項目

regGetVal -- レジストリの値を取得する（関数）

regSetKeyValues -- 配列のレジストリ キーの値を設定する（関数）