分享

windows API 操作注册表函数

 pgj555 2014-01-22
如今修改注册表成为继超频之后的又一大热点,许多CFAN通过对注册表的修改使Win98显得更加个性化,诸多报刊杂志也纷纷扯起注册表这面旗帜,令人遗憾的是,在介绍注册表修改的众多的文章中,大都以手工修改为例,极少数文章也只介绍有关修改注册表软件的用法,至于如何在程序中实现却无人提及。为此我在Visual
Studio6.0帮助文件中用Registry关键字进行搜索,在翻译软件帮助下及不断的上机实践下,我终于摸索出使用注册表接口(API)函数的一些用法,现拿出来与大家共享。


  在程序中使用注册表,不外乎创建、打开、读取、设置、删除这五个常规操作,(要想获得更详细的资料可以参考Visual Studio6.0帮助目录中MSDN Library Visual Studio6.0|Platform SDK|Window Base Services|General Library|Registry条目)。下面我们就来关注这五个接口函数的用法:

  一、 创建键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<STR. GetLength( );i++)lpb[i]="str[i];

  lpb[str.GetLength( )]=0;

  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;

  }

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多