网络安全编程：注册表操作常用API函数

注册表的操作和文件的操作非常类似，也存在打开、关闭、写入、查询等操作，也就是“增、删、改、查”的功能都具备，只是所使用的API函数都是以Reg开头的。

1. 打开和关闭注册表

操作注册表需要通过可以操作注册表的句柄，与文件操作类似。对注册表进行读写前，需要通过API函数打开注册表，并返回用于操作注册表的句柄，通过操作注册表的API函数来打开返回的句柄，然后对注册表进行读写操作。当读写操作完成后，再通过API函数将打开的注册表句柄进行关闭。

打开注册表使用的函数是RegOpenKeyEx()。在Win16下有一个函数名为RegOpenKey()，虽然这个函数在Win32下仍然可用，但是这是为了兼容目的而设置的。RegOpenKeyEx()函数的定义如下：

参数说明如下。

hKey：指定一个父键句柄。

lpSubKey：指向一个字符串，用来表示要打开的子键名称。

ulOptions：系统保留，必须指定为 0 值。

samDesired： 打开注册表的存取权限，为了方便对注册表的操作，通常使用 KEY_ALL_ACCESS 即可。

phkResult：指向一个双子变量，用来接收打开的子键句柄。

如果函数执行成功，则返回 ERROR_SUCCESS，并且在 phkResult 中保存返回打开子键的句柄。

所谓打开注册表，实质是打开注册表的某一个子键，然后进行操作。

当对注册表操作完成后，则需要关闭已打开的注册表句柄以便释放资源。关闭释放注册表句柄的函数定义如下：

该函数只有一个参数，是RegOpenKeyEx()函数的最后一个参数，即被打开的注册表句柄。

2. 创建和删除子键

创建一个子键的API函数为RegCreateKeyEx()，其定义如下：

参数说明如下。

hKey：用来指定父键句柄。

lpSubKey：指向一个字符串，用来表示要创建的子键名称。

Reserved： 系统保留，必须指定为 0 值。

lpClass： 子键类名，一般设置为 NULL 值。

dwOptions：创建子键时的选项，通常情况下使用REG_OPTION_NON_VOLATILE宏，表示创建的子键被创建到注册表文件中，而不是内存中。

samDesired： 打开注册表的存取权限，为了方便对注册表的操作，通常使用 KEY_ALL_ ACCESS 即可。

lpSecurityAttributes： 该参数指向一个 SECURITY_ATTRIBUTES 结构体，用来指定键句柄的安全属性，这里一般使用NULL。

phkResult：指向一个双子变量，用来接收打开的子键句柄。

lpdwDisposition： 一般设置为 NULL 值。

如果函数执行成功，则返回ERROR_SUCCESS，并且在phkResult中保存返回创建子键的句柄。当需要创建的子键已经存在的时候，该函数起到与RegOpenKeyEx()函数同样的作用，那么打开注册表也可以使用RegCreateKeyEx()函数进行代替。不过该函数的参数比RegOpenKeyEx()函数的参数多。因此为了在写代码时更简便，打开注册表的操作还是使用RegOpenKeyEx()函数较为省事。

删除子键使用RegDeleteKey()函数，其定义如下：

该函数的值能用来删除键值项，也就是函数只能删除最下一层的子键。函数有2个参数，hKey为父键句柄，lpSubKey为指向要删除的子键名称字符串。

3. 注册表键值的查询、写入与删除

读取键名称中的数据或者查询键名称的属性使用RegQueryValueEx()函数，其定义如下：

参数说明如下。

hKey：用来指定要读取的键值项所处的子键句柄。

lpValueName：用来指定要读取的键值项的名称。

lpReserved： 保留参数，必须为 NULL 值。

lpType： 接收返回的键值类型，如果不需要返回键值项类型，可以给 NULL 值。

lpData：指向一个缓冲区，用来接收返回的键值数据。

lpcbData：在调用该函数时，这个参数用来指定缓冲区的长度；当函数返回时，该变量保存缓冲区实际接收到的长度。

写入键值项的函数为 RegSetValueEx()，其定义如下：

参数说明如下。

hKey：用来指定要写入的键值项所处的子键句柄。

lpValueName：指向定义键值项名称的字符串。

Reserved： 保留参数，必须为 0 值。

dwType：指出要写入的键值数据的类型。

lpData：指向要写入键值数据的缓冲区。

cbData：要写入键值数据的缓冲区长度。

删除键值项的函数为RegDeleteValue()，其定义如下：

参数说明如下。

hKey：用来指定删除的句柄。

lpValueName：被删除键值项的名称。

4. 子键和键值的枚举

枚举就是逐一获取。子键的枚举对指定键下面的子键进行逐一的获取。键值的枚举是对指定子键下的键值进行逐一的获取。

枚举子键的函数为RegEnumKeyEx()，其定义如下：

参数说明如下。

hKey：指定被枚举的键句柄。

dwIndex：指定需要返回信息的子键索引编号。

lpName：用户接收返回子键名称的缓冲区。

lpcName： 在调用该函数前，该参数保存 lpName 指向缓冲区的长度；在该函数调用完成后，该参数保存缓冲区实际接收到的数据的长度。

lpReserved： 保留参数，必须为 NULL 值。

lpClass： 一般为 NULL 值。

lpcClass： 一般为 NULL 值。

lpftLastWriteTime： 指向一个 FILETIME 结构体，用于接收最后一次被写入的时间。

枚举键值的函数为RegEnumValue()，其定义如下：

参数说明如下。

hKey：指定被枚举的键句柄。

dwIndex：指定需要返回信息的键值索引编号。

lpValueName：用户接收返回键值名称的缓冲区。

lpcValueName：在调用该函数前，该参数保存 lpValueName 指向缓冲区的长度；在该函数调用完成后，该参数保存缓冲区实际接收到的数据的长度。

lpReserved： 保留参数，必须为 NULL 值。

lpType：指向一个用于返回键值数据类型的双字变量。

lpData：用户接收返回键值数据的缓冲区。

lpcbData： 在调用该函数前，该参数保存 lpData 指向缓冲区的长度；在该函数调用完成后，该参数保存缓冲区实际收到的数据的长度。

与注册表操作相关的函数就介绍到这里。以上是注册表操作的常用函数，这里无法将注册表操作相关的函数一一介绍，其他相关函数在具体使用时请参考 MSDN 进行学习。