注册表的操作和文件的操作非常类似,也存在打开、关闭、写入、查询等操作,也就是“增、删、改、查”的功能都具备,只是所使用的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 即可。
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 即可。
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 进行学习。
文章标题:网络安全编程:注册表操作常用API函数
URL网址:http://www.shufengxianlan.com/qtweb/news38/312388.html
网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等
声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联