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

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

1. 打开和关闭注册表

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

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

LONGRegOpenKeyEx(
HKEYhKey,//handletoopenkey
LPCTSTRlpSubKey,//subkeyname
DWORDulOptions,//reserved
REGSAMsamDesired,//securityaccessmask
PHKEYphkResult//handletoopenkey
);

参数说明如下。

hKey：指定一个父键句柄。

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

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

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

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

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

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

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

LONGRegCloseKey(
HKEYhKey//handletokeytoclose
);

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

2. 创建和删除子键

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

LONGRegCreateKeyEx(
HKEYhKey,//handletoopenkey
LPCTSTRlpSubKey,//subkeyname
DWORDReserved,//reserved
LPTSTRlpClass,//classstring
DWORDdwOptions,//specialoptions
REGSAMsamDesired,//desiredsecurityaccess
LPSECURITY_ATTRIBUTESlpSecurityAttributes,//inheritance
PHKEYphkResult,//keyhandle
LPDWORDlpdwDisposition//dispositionvaluebuffer
);

参数说明如下。

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()函数，其定义如下：

LONGRegDeleteKey(
HKEYhKey,//handletoopenkey
LPCTSTRlpSubKey//subkeyname
);

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

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

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

LONGRegQueryValueEx(
HKEYhKey,//handletokey
LPCTSTRlpValueName,//valuename
LPDWORDlpReserved,//reserved
LPDWORDlpType,//typebuffer
LPBYTElpData,//databuffer
LPDWORDlpcbData//sizeofdatabuffer
);

参数说明如下。

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

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

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

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

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

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

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

LONGRegSetValueEx(
HKEYhKey,//handletokey
LPCTSTRlpValueName,//valuename
DWORDReserved,//reserved
DWORDdwType,//valuetype
CONSTBYTE*lpData,//valuedata
DWORDcbData//sizeofvaluedata
);

参数说明如下。

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

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

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

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

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

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

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

LONGRegDeleteValue(
HKEYhKey,//handletokey
LPCTSTRlpValueName//valuename
);

参数说明如下。

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

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

4. 子键和键值的枚举

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

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

LONGRegEnumKeyEx(
HKEYhKey,//handletokeytoenumerate
DWORDdwIndex,//subkeyindex
LPTSTRlpName,//subkeyname
LPDWORDlpcName,//sizeofsubkeybuffer
LPDWORDlpReserved,//reserved
LPTSTRlpClass,//classstringbuffer
LPDWORDlpcClass,//sizeofclassstringbuffer
PFILETIMElpftLastWriteTime//lastwritetime
);

参数说明如下。

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

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

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

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

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

lpClass：一般为 NULL 值。

lpcClass：一般为 NULL 值。

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

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

LONGRegEnumValue(
HKEYhKey,//handletokeytoquery
DWORDdwIndex,//indexofvaluetoquery
LPTSTRlpValueName,//valuebuffer
LPDWORDlpcValueName,//sizeofvaluebuffer
LPDWORDlpReserved,//reserved
LPDWORDlpType,//typebuffer
LPBYTElpData,//databuffer
LPDWORDlpcbData//sizeofdatabuffer
);

参数说明如下。

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

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

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

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

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

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

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

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

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