模块 registry

registry 模块是一个操作 Windows 注册表（Registry）的模块。它提供了访问注册表的方法和常量，可以读取、修改、删除、添加等操作。registry 模块提供的操作方式和 Windows 应用程序使用的方式类似，但却是在 FibJS 中提供了能力。常量有常见的 Root、 数据类型等常量，还有一些用于不同操作的返回值的常量

常用的函数有：

1. get(root, key[, flags])：获取指定注册表项的值。
2. set(root, key, value[, type])：设置指定注册表项的值。
3. del(root, key)：删除指定注册表项。

接下来，我们验证某个注册表项在指定注册表分支上的键值是否存在，然后将该键值读取。如果不存在，就将该键值写入到指定注册表项。代码如下所示：

1
2
3
4
5
6
7
8
9
10
var registry = require('registry');

// specify the key name
var key = "Software\\Fibjs\\Test\\KeyName";
if (!registry.get(registry.CLASSES_ROOT, key)) {
    registry.set(registry.CLASSES_ROOT, key, "test_value");
}
// specify the key name
var value = registry.get(registry.CLASSES_ROOT, key);
console.log(value);

该程序首先验证注册表项是否存在，如果不存在，则写入注册表，键名为 Software\Fibjs\Test\KeyName，并将值设置为 test_value。最后，读取该注册表的键值并在控制台输出。 上面的代码展示了 registry 模块的基本用法，可以通过这个模块很方便地读取、修改、添加、删除注册表中的信息。

静态函数

listSubKey

返回指定键值下的所有子健

1
2
static NArray registry.listSubKey(Integer root,
    String key);

调用参数:

• root: Integer, 指定注册表根
• key: String, 指定键值

返回结果:

• NArray, 返回该键值下所有子健

---

listValue

返回指定键值下的所有数据的健

1
2
static NArray registry.listValue(Integer root,
    String key);

调用参数:

• root: Integer, 指定注册表根
• key: String, 指定键值

返回结果:

• NArray, 返回该键值下所有数据的健

---

get

查询指定键值的数值

1
2
static Value registry.get(Integer root,
    String key);

调用参数:

• root: Integer, 指定注册表根
• key: String, 指定键值

返回结果:

• Value, 返回指定键值的数值

---

set

设置指定键值为数字

1
2
3
4
static registry.set(Integer root,
    String key,
    Number value,
    Integer type = DWORD);

调用参数:

• root: Integer, 指定注册表根
• key: String, 指定键值
• value: Number, 指定数字
• type: Integer, 指定类型，允许的类型为 DWORD 和 QWORD，缺省为 DWORD

---

设置指定键值为字符串

1
2
3
4
static registry.set(Integer root,
    String key,
    String value,
    Integer type = SZ);

调用参数:

• root: Integer, 指定注册表根
• key: String, 指定键值
• value: String, 指定字符串
• type: Integer, 指定类型，允许的类型为 SZ 和 EXPAND_SZ，缺省为 SZ

---

设置指定键值为多字符串

1
2
3
static registry.set(Integer root,
    String key,
    Array value);

调用参数:

• root: Integer, 指定注册表根
• key: String, 指定键值
• value: Array, 指定多字符串数组

---

设置指定键值为二进制

1
2
3
static registry.set(Integer root,
    String key,
    Buffer value);

调用参数:

• root: Integer, 指定注册表根
• key: String, 指定键值
• value: Buffer, 指定二进制数据

---

del

删除指定键值的数值

1
2
static registry.del(Integer root,
    String key);

调用参数:

• root: Integer, 指定注册表根
• key: String, 指定键值

常量

CLASSES_ROOT

注册表根，存储Windows可识别的文件类型的详细列表，以及相关联的程序

1
const registry.CLASSES_ROOT = 0;

---

CURRENT_USER

注册表根，存储当前用户设置的信息

1
const registry.CURRENT_USER = 1;

---

LOCAL_MACHINE

注册表根，包括安装在计算机上的硬件和软件的信息

1
const registry.LOCAL_MACHINE = 2;

---

USERS

注册表根，包含使用计算机的用户的信息

1
const registry.USERS = 3;

---

CURRENT_CONFIG

注册表根，这个分支包含计算机当前的硬件配置信息

1
const registry.CURRENT_CONFIG = 5;

---

SZ

注册表数据类型，字符串

1
const registry.SZ = 1;

---

EXPAND_SZ

注册表数据类型，扩展字符串

1
const registry.EXPAND_SZ = 2;

---

DWORD

注册表数据类型，32 位数值

1
const registry.DWORD = 4;

---

QWORD

注册表数据类型，64 位数值

1
const registry.QWORD = 11;