参考指南 › AutoShell › AutoShell 核心参考 › AutoShell 功能 › regGetKeyValues－获取注册表项值信息（函数）

regGetKeyValues－获取注册表项值信息（函数）

regGetKeyValues 函数返回一个二维数组，其中包含本地系统或远程系统上某注册表项的名称、实际值和注册表值的类型。 返回的数组可以传递到 regSetKeyValues()，以将值设置从一个系统复制到另一个系统。

该函数具有以下语法：

regGetKeyValues(sKey)

sKey

指定注册表项。

该函数将返回一个二维数组。 每个顶级元素包含一个三元素子数组，其中包含表示值名称的字符串、设置的多态值和值类型的整数。 注册表值的类型决定了返回值的类型。

• 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;
        默认:
          ? "Unknown"
      }
    }

从远程系统 client8 获取值，并将其应用于远程系统 client9：

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

另请参阅：

regGetVal－获取注册表值（函数）

regSetKeyValues－从数组设置注册表项值（函数）