3.2.2 注册表操作常用API函数介绍
注册表的操作和文件的操作非常类似，也存在打开、关闭、写入、查询等操作，也就是“增、删、改、查”的功能都具备，只是所使用的API函数都是以Reg开头的。
1．打开和关闭注册表
操作注册表需要通过可以操作注册表的句柄，与文件操作类似。对注册表进行读写前，需要通过API函数打开注册表，并返回用于操作注册表的句柄，通过操作注册表的API函数来打开返回的句柄，然后对注册表进行读写操作。当读写操作完成后，再通过API函数将打开的注册表句柄进行关闭。
打开注册表使用的函数是RegOpenKeyEx()。在Win16下有一个函数名为RegOpenKey()，虽然这个函数在Win32下仍然可用，但是这是为了兼容目的而设置的。RegOpenKeyEx()函数的定义如下：
LONG RegOpenKeyEx(
HKEY hKey, // handle to open key
LPCTSTR lpSubKey, // subkey name
DWORD ulOptions, // reserved
REGSAM samDesired, // security access mask
PHKEY phkResult // handle to open key
);
参数说明如下。
hKey：指定一个父键句柄。
lpSubKey：指向一个字符串，用来表示要打开的子键名称。
ulOptions：系统保留，必须指定为0值。
samDesired：打开注册表的存取权限，为了方便对注册表的操作，通常使用KEY_ALL_ACCESS即可，具体更多的打开方式请参考MSDN。
phkResult：指向一个双子变量，用来接收打开的子键句柄。
如果函数执行成功，则返回ERROR_SUCCESS，并且在phkResult中保存返回打开子键的句柄。
注：所谓打开注册表，实质是打开注册表的某一个子键，然后进行操作。
当对注册表操作完成后，则需要关闭已打开的注册表句柄以便释放资源。关闭释放注册表句柄的函数定义如下：
LONG RegCloseKey(
HKEY hKey // handle to key to close
);
该函数只有一个参数，是RegOpenKeyEx()函数的最后一个参数，即被打开的注册表句柄。
2．创建和删除子键
创建一个子键的API函数为RegCreateKeyEx()，其定义如下：
LONG RegCreateKeyEx(
HKEY hKey, // handle to open key
LPCTSTR lpSubKey, // subkey name
DWORD Reserved, // reserved
LPTSTR lpClass, // class string
DWORD dwOptions, // special options
REGSAM samDesired, // desired security access
LPSECURITY_ATTRIBUTES lpSecurityAttributes, // inheritance
PHKEY phkResult, // key handle
LPDWORD lpdwDisposition // disposition value buffer
);
参数说明如下。
hKey：用来指定父键句柄。
lpSubKey：指向一个字符串，用来表示要创建的子键名称。
Reserved：系统保留，必须指定为0值。
lpClass：子键类名，一般设置为NULL值。
dwOptions：创建子键时的选项，通常情况下使用REG_OPTION_NON_VOLATILE宏，表示创建的子键被创建到注册表文件中，而不是内存中。
samDesired：打开注册表的存取权限，为了方便对注册表的操作，通常使用KEY_ALL_ACCESS即可，具体方式请参考MSDN。
lpSecurityAttributes：该参数指向一个SECURITY_ATTRIBUTES结构体，用来指定键句柄的安全属性，这里一般使用NULL。
phkResult：指向一个双子变量，用来接收打开的子键句柄。
lpdwDisposition：一般设置为NULL值。
如果函数执行成功，则返回ERROR_SUCCESS，并且在phkResult中保存返回创建子键的句柄。当需要创建的子键已经存在的时候，该函数起到与RegOpenKeyEx()函数同样的作用，那么打开注册表也可以使用RegCreateKeyEx()函数进行代替。不过该函数的参数比RegOpenKeyEx()函数的参数多。因此为了在书写代码时更简便，打开注册表的操作还是使用RegOpenKeyEx()函数较为省事。
删除子键使用RegDeleteKey()函数，其定义如下：
LONG RegDeleteKey(
HKEY hKey, // handle to open key
LPCTSTR lpSubKey // subkey name
);
该函数的值能用来删除键值项，也就是函数只能删除最下一层的子键。函数有2个参数，hKey为父键句柄，lpSubKey为指向要删除的子键名称字符串。
3．注册表键值的查询、写入与删除
读取键名称中的数据或者查询键名称的属性使用RegQueryValueEx()函数，其定义如下：
LONG RegQueryValueEx(
HKEY hKey, // handle to key
LPCTSTR lpValueName, // value name
LPDWORD lpReserved, // reserved
LPDWORD lpType, // type buffer
LPBYTE lpData, // data buffer
LPDWORD lpcbData // size of data buffer
);
参数说明如下。
hKey：用来指定要读取的键值项所处的子键句柄。
lpValueName：用来指定要读取的键值项的名称。
lpReserved：保留参数，必须为NULL值。
lpType：接收返回的键值类型，如果不需要返回键值项类型，可以给NULL值。
lpData：指向一个缓冲区，用来接收返回的键值数据。
lpcbData：在调用该函数时，这个参数用来指定缓冲区的长度；当函数返回时，该变量保存缓冲区实际接收到的长度。
写入键值项的函数为RegSetValueEx()，其定义如下：
LONG RegSetValueEx(
HKEY hKey, // handle to key
LPCTSTR lpValueName, // value name
DWORD Reserved, // reserved
DWORD dwType, // value type
CONST BYTE *lpData, // value data
DWORD cbData // size of value data
);
参数说明如下。
hKey：用来指定要写入的键值项所处的子键句柄。
lpValueName：指向定义键值项名称的字符串。
Reserved：保留参数，必须为0值。
dwType：指出要写入的键值数据的类型。
lpData：指向要写入键值数据的缓冲区。
cbData：要写入键值数据的缓冲区长度。
删除键值项的函数为RegDeleteValue()，其定义如下：
LONG RegDeleteValue(
HKEY hKey, // handle to key
LPCTSTR lpValueName // value name
);
参数说明如下。
hKey：用来指定删除的句柄。
lpValueName：被删除键值项的名称。
4．子键和键值的枚举
枚举就是逐一获取。子键的枚举对指定键下面的子键进行逐一的获取。键值的枚举是对指定子键下的键值进行逐一的获取。
枚举子键的函数为RegEnumKeyEx()，其定义如下：
LONG RegEnumKeyEx(
HKEY hKey, // handle to key to enumerate
DWORD dwIndex, // subkey index
LPTSTR lpName, // subkey name
LPDWORD lpcName, // size of subkey buffer
LPDWORD lpReserved, // reserved
LPTSTR lpClass, // class string buffer
LPDWORD lpcClass, // size of class string buffer
PFILETIME lpftLastWriteTime // last write time
);
参数说明如下。
hKey：指定被枚举的键句柄。
dwIndex：指定需要返回信息的子键索引编号。
lpName：用户接收返回子键名称的缓冲区。
lpcName：在调用该函数前，该参数保存lpName指向缓冲区的长度；在该函数调用完成后，该参数保存缓冲区实际接收到的数据的长度。
lpReserved：保留参数，必须为NULL值。
lpClass：一般为NULL值。
lpcClass：一般为NULL值。
lpftLastWriteTime：指向一个FILETIME结构体，用于接收最后一次被写入的时间。
枚举键值的函数为RegEnumValue()，其定义如下：
LONG RegEnumValue(
HKEY hKey, // handle to key to query
DWORD dwIndex, // index of value to query
LPTSTR lpValueName, // value buffer
LPDWORD lpcValueName, // size of value buffer
LPDWORD lpReserved, // reserved
LPDWORD lpType, // type buffer
LPBYTE lpData, // data buffer
LPDWORD lpcbData // size of data buffer
);
参数说明如下。
hKey：指定被枚举的键句柄。
dwIndex：指定需要返回信息的键值索引编号。
lpValueName：用户接收返回键值名称的缓冲区。
lpcValueName：在调用该函数前，该参数保存lpValueName指向缓冲区的长度；在该函数调用完成后，该参数保存缓冲区实际接收到的数据的长度。
lpReserved：保留参数，必须为NULL值。
lpType：指向一个用于返回键值数据类型的双字变量。
lpData：用户接收返回键值数据的缓冲区。
lpcbData：在调用该函数前，该参数保存lpData指向缓冲区的长度；在该函数调用完成后，该参数保存缓冲区实际收到的数据的长度。
与注册表操作相关的函数就介绍到这里。以上是注册表操作的常用函数，这里无法将注册表操作相关的函数一一介绍，其他相关函数在具体使用时请参考MSDN进行学习。