如何在VC++中使用注册表
如何在VC++中使用注册表
如今修改注册表成为继超频之后的又一大热点,许多CFAN通过对注册表的修改使Win98显得更加个性化,诸多报刊杂志也纷纷扯起注册表这面旗帜,令人遗憾的是,在介绍注册表修改的众多的文章中,大都以手工修改为例,极少数文章也只介绍有关修改注册表软件的用法,至于如何在程序中实现却无人提及。为此我在Visual Studio6.0帮助文件中用Registry关键字进行搜索,在翻译软件帮助下及不断的上机实践下,我终于摸索出使用注册表接口(API)函数的一些用法,现拿出来与大家共享。
在程序中使用注册表,不外乎创建、打开、读取、设置、删除这五个常规操作,(要想获得更详细的资料可以参考Visual Studio6.0帮助目录中MSDN Library Visual Studio6.0Platform SDKWindow Base ServicesGeneral LibraryRegistry条目)。下面我们就来关注这五个接口函数的用法:
一、 创建键RegCreateKeyEx
通过RegCreateKeyEx函数可以在注册表中创建键,如果需要创建的键已经存在了,则打开键。函数原型如下:
LONG RegCreateKeyEx(
HKEY hKey,
LPCTSTR lpSubKey,
DWORD Reserved,
LPTSTR lpClass,
DWORD dwOptions,
REGSAM samDesired,
LPSECURITY_ATTRIBUTESlpSecurityAttributes,
PHKEY phkResult,
LPDWORD lpdwDisposition
);
各参数及返回值的含义如下:
?hKey为主键值,可以取下面的一些数值:
HKEY_CLASSES_ROOT、HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER、HKEY_LOCAL_MACHINE
HKEY_USER、HKEY_PERFORMANCE_DATA(WINNT操作系统)
HKEY_DYN_DATA(WIN9X操作系统)
?参数lpSubKey为一个指向以零结尾的字符串的指针,其中包含将要创建或打开的子键的名称。子键不可以用反斜线()开始。该参数可以为NULL。
?Reserved保留,必须设置为0。
?参数lpClass一个指向包含键类型的字符串。如果该键已经存在,则忽略该参数。
?参数dwOptions为新创建的键设置一定的属性。可以取下面的一些数值:
REG_OPTION_NON_VOLATILE 新创建的键为一个非短暂性的键(数据信息保存在文件中,当系统重新启动时,数据信息恢复)
REG_OPTION_VOLATILE 新创建的键为一个短暂性的键(数据信息保存在内存中)。Windows95忽略该数值。
REG_OPTION_BACKUP_RESTORE 仅在WINNT中支持,可以提供优先级支持。
?参数samDesired用来设置对键访问的权限,可以取下面的一些数值:
KEY_CREATE_LINK 准许生成符号键
KEY_CREATE_SUB_KEY 准许生成子键
KEY_ENUMERATE_SUB_KEYS 准许生成枚举子键
KEY_EXECUTE 准许进行读操作
KEY_NOTIFY 准许更换通告
KEY_QUERY_VALUE 准许查询子键
KEY_ALL_ACCESS 提供完全访问,是上面数值的组合
KEY_READ 是下面数值的组合:
KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS、KEY_NOTIFY
KEY_SET_VALUE 准许设置子键的数值
KEY_WRITE 是下面数值的组合:
KEY_SET_VALUE、KEY_CREATE_SUB_KEY
?参数lpSecurityAttributes为一个指向SECURITY_ATTRIBUTES结构的指针,确定返回的句柄是否被子处理过程继承。如果该参数为NULL,则句柄不可以被继承。在WINNT中,该参数可以为新创建的键增加安全的描述。
?参数phkResult为一个指向新创建或打开的键的句柄的指针。
?参数lpdwDispition指明键是被创建还是被打开的,可以是下面的一些数值:
REG_CREATE_NEW_KEY 键先前不存在,现在被创建。
REG_OPENED_EXISTING_KEY 键先前已存在,现在被打开。
?返回值 如果函数调用成功,则返回ERROR_SUCCESS。否则,返回值为文件WINERROR.h中定义的一个非零的错误代码,可以通过设置FORMAT_MESSAGE_FROM_SYSTEM标识调用FormatMessage函数来获取一个对错误的总体描述。
二、 打开一个键RegOpenKeyEx
RegOpenKeyEx函数可以打开一个指定的键,函数原型如下:
LONG RegOpenKeyEx(
HKEY hkey,
LPCTSTR lpSubKey,
DWORD ulOption,
REGSAM samDesired,
PHKEY phkResult
);
各参数及返回值的含义如下:
?参数hKey的含义同RegCreateKeyEx函数中的hKey参数。
?参数lpSubKey为一个指向以零结尾的字符串的指针,其中包含子键的名称,可以利用反斜线()分隔不同的子键名。如果字符串为空,则根据hKey参数创建一个新的句柄。在这种情况下,并不关闭先前打开的句柄。
?ulOption保留,通常必须设置为0。
?参数samDesired的含义同RegCreateKeyEx函数中的samDesired参数。
?参数phkResult为一个指针,用来指向打开的键的句柄。可以通过RegCloseKey函数关闭这个句柄。
?返回值同RegCreateKeyEx函数的返回值。
三、 读取键RegQueryValueEx
通过RegQueryValueEx函数可以从一个已经打开的键中读取数据,函数原型如下:
LONG RegQueryValueEx(
HKEY hKey,
LPTSTR lpValueName,
LPDWORD lpReserved,
LPDWORD lpType,
LPBYTE lpData,
LPDWORD lpcbData
);
各个参数及返回值的含义如下:
?参数hKey为当前的一个打开的键的句柄,具体数值同RegCreateKeyEx函数的hKey参数。
?参数lpVauleName为一个指向非空的包含查询值的名称的字符串指针。
?lpReserved保留,必须为NULL。
?参数lpType为一个指向数据类型的指针,数据类型为下列类型之一:
REG_BINARY 二进制数据
REG_DWORD 32位整数
REG_DWORD_LITTLE_ENDIAN little-endian格式的数据,例如0X12345678以(0X78 0X56 0X34 0X12)方式保存
REG_DWORD_BIG_ENDIAN big-endian格式的数据,例如0X12345678以(0X12 0X34 0X56 0X78)方式保存
REG_EXPAND_SZ 一个包含未扩展环境变量的字符串
REG_LINK 一个Unicode类型的链接
REG_MULIT_SZ 以两个零结尾的字符串
REG_NONE 无类型数值
REG_RESOURCE_LIST 设备驱动资源列表
REG_SZ 一个以零结尾的字符串根据函数使用的字符集类型的不同而设置为Unicode或ANSI类型的字符串
?参数lpData为一个指向保存返回值的变量的指针。如果不需要返回值,该参数可以为NULL。
?参数lpcbData为一个指向保存返回值长度的变量的指针。其中长度以字节为单位。如果数据类型为REG_SZ、REG_MULTI_SZ或REG_EXPAND_SZ,那么长度也包括结尾的零字符,只有在参数lpData为NULL时,参数lpcbData才可以为NULL。
?返回值同RegCreateKeyEx函数的返回值。
四、 设置键值RegSetValueEx
RegSetValueEx函数可以设置注册表中键的值,函数原型如下:
LONG RegSetValueEx(
HKEY hKey,
LPCTSTR lpValueName,
DWORD Reserved,
DWORD dwType,
CONST BYTE *lpData,
DWORD cbData
);
各个参数及返回值的含义如下:
?参数hKey的含义同RegCreateKeyEx函数中的hKey参数。
?参数lpValueName为一个指向包含值名的字符串指针。
?Reserved保留,通常必须设置为0。
?参数dwType确定了设置的值的类型同RegQueryValueKeyEx的lyType参数。
?参数lpData为一个指向包含数据的缓冲区的指针。
?参数cbData以字节为单位,指定数据的长度。
?返回值同RegCreateKeyEx函数的返回值。
五、 删除键值RegDeketeKey
函数RegDeketeKey删除一个键及所有的子键。函数原型如下:
LONG RegDeleteKey(
HKEY hKey,
LPCTSTR lpSubKEY
);
各个参数及返回值的含义如下:
?参数hKey的含义同RegCreateKeyEx函数中的hKey参数。
?参数lpSubKey的含义同RegCreateKeyEx函数中的lpSubKey参数。
六、 示例
下面我们在Visual C++6.0或5.0环境中新建一基于对话框的工程。设置两个命令按钮,名为“查询用户信息”和“修改用户信息”,用来查询和修改注册表中的用户姓名和公司名称。需要说明的是,用户的信息位于系统注册表中KEY-CURRENT-USERSoftwareMicrsoftMS Setup(ACME)User Info的位置,键值名DefName和DefCompany分别表示用户的姓名和用户公司的名称。
1、 查询用户信息的代码
HKEY hKey; //定义有关的hKey,在查询结束时要关闭。
LPCTSTR path="Software\Micrsoft\MS Setup(ACME)\User Info\”;
LONG return0=(::RegOpenKeyEx(HKEY_CURRENT_USER,path,0,KEY_READ,&hKey));
if(return0!=ERROR_SUCCESS)
{
MessageBox("错误:无法打开有关的键!");
Return;
}
LPBYTE username_Get=new BYTE[80];
DWORD type_1=REG_SZ;
DWORD cbData_1=80;
LONG return1=::RegQueryValueEx(hKey,"Defname:,NULL,&type_1,
username_Get,&cbData_1);
if(return1!=ERROR_SUCCESS)
{
MessageBox("错误:无法查询有关注册表信息!");
Return;
}
LPBYTE company_Get=new BYTE[80];
DWORD type_2=REG_SZ;
DWORD cbData_2=80;
LONG return2=::RegQueryValueEx(hKey,"DefCompany",NULL,&type_2,
company_Get,&cbData_2);
if(return2!=ERROR_SUCCESS)
{
MessageBox("错误:无法查询有关注册表信息!");
Return;
}
//将username_Get和company_Get转换为CString字符串,以便显示输出
CString str_username=CString(username_Get);
CString str_company=CString(company_Get);
delete[] username_Get;
delete[] company_Get;
//程序结束前关闭已经打开的hKey
::RegCloseKey(hKey);
……
字符串str_username和str_company表示查询的用户的姓名和公司的名称。
2、修改用户信息的代码
因用户输出的是CString类型的字符串,要先将其转换为LPBYTE类型,以便以后函数的调用。下面是转换函数:
LPBYTE CString_To_LPBYTE(CString str)
{
LPBYTE lpb=new BYTE [str.GetLength( )+1];
for(int i=0;i
return lpb;
}
以下是具体的修改注册表用户信息的代码:
CString str_username,str_company;
HKEY hKey;
LPCTSTR path=“Software\Micrsoft\MS Setup(ACME)\User Info\”;
LONG return0(::RegOpenKeyEx(HKEY_CURRENT_USER,path,0,KEY_WRITE,&hKey));
if(return0!=ERROR_SUCCESS)
{
MessageBox(“错误:无法打开有关的键!”);
return;
}
LPBYTE username_Set=Cstring_To_LPBYTE(str_username);
DWORD type_1=REG_SZ;
DWORD cbData_1=str_username.GetLength( )+1;
LONG return1=::RegSetalueEx(hKey,"DefName",NULL,type_1,username_Set,cbData_1);
if (return1!=ERROR_SUCCESS)
{
MessageBox(“错误:无法修改有关注册表信息!”);
return;
}
LPBYTE company_Set=Cstring_To_LPBYTE(str_company);
DWORD type_2=REG_SZ;
DWORD cbData_2=str_COMPANY.GetLength( )+1;
LONG return2=::RegSetalueEx(hKey,"DefCompany",NULL,type_2,company_Set,cbData_2);
if (return2!=ERROR_SUCCESS)
{
MessageBox(“错误:无法修改有关注册表信息!”);
return;
}