C++中注册表操作

C++接触了一段时间，最近在捣鼓PatrolBot移动机器人小车，在看源码的时候发现有对注册表操作的代码，第一次接触，便来此记录一番。

首先把用到注册表操作的这个函数（ArUtil类的成员函数）搬上来，该函数功能是从注册表中获取一个字符串。

AREXPORT bool ArUtil::getStringFromRegistry(REGKEY root,   const char *key,   const char *value,   char *str,   int len){#ifndef WIN32  return false;#else // WIN32  HKEY hkey;  int err;  unsigned long numKeys;  unsigned long longestKey;  unsigned long numValues;  unsigned long longestValue;  unsigned long longestDataLength;  char *valueName;  unsigned long valueLength;  unsigned long type;  char *data;  unsigned long dataLength;  HKEY rootKey;  switch (root)  {  case REGKEY_CLASSES_ROOT:    rootKey = HKEY_CLASSES_ROOT;    break;  case REGKEY_CURRENT_CONFIG:    rootKey = HKEY_CURRENT_CONFIG;    break;  case REGKEY_CURRENT_USER:    rootKey = HKEY_CURRENT_USER;    break;  case REGKEY_LOCAL_MACHINE:    rootKey = HKEY_LOCAL_MACHINE;    break;  case REGKEY_USERS:    rootKey=HKEY_USERS;    break;  default:    ArLog::log(ArLog::Terse,        "ArUtil::getStringFromRegistry: Bad root key given.");    return false;  }  /// 打开一个指定的注册表键  if ((err = RegOpenKeyEx(rootKey, key, 0, KEY_READ, &hkey)) == ERROR_SUCCESS)  {    //printf("Got a key\n");    if (RegQueryInfoKey(hkey, NULL, NULL, NULL, &numKeys, &longestKey, NULL, &numValues, &longestValue, &longestDataLength, NULL, NULL) == ERROR_SUCCESS)    {       data = new char[longestDataLength+2];      valueName = new char[longestValue+2];      for (unsigned long i = 0; i < numValues; ++i)      {dataLength = longestDataLength+1;valueLength = longestValue+1;if ((err = RegEnumValue(hkey, i, valueName, &valueLength, NULL, //用来枚举指定项的值。&type, (unsigned char *)data, &dataLength)) == ERROR_SUCCESS){//printf("Enumed value %d, name is %s, value is %s\n", i, valueName, data);  if (strcmp(value, valueName) == 0)  {    if (len < dataLength)    {      ArLog::log(ArLog::Terse,"ArUtil::getStringFromRegistry: str passed in not long enough for data.");      delete data;      delete valueName;      return false;    }    strncpy(str, data, len);    delete data;    delete valueName;    return true;  }}      }      delete data;      delete valueName;    }  }  return false;#endif}

其中，关于注册表操作的函数只要三个：

1. RegOpenKeyEx

2. RegQueryInfoKey

3. RegEnumValue

下面，我们逐一介绍这三个函数。

1. RegOpenKeyEx

WINADVAPI LSTATUS APIENTRY RegOpenKeyEx (HKEY hKey, LPCWSTR lpSubKey, DWORD ulOptions, REGSAM samDesired, PHKEY phkResult);

函数功能：打开一个指定的注册表键

参数hKey：需要打开的主键的名称，HKEY_CLASSES_ROOT / HKEY_CURRENT_CONFIG / HKEY_CURRENT_USER / HKEY_LOCAL_MACHINE / HKEY_USERS，这五个中的一个哦~

参数lpSubKey：需要打开的子键的名称

参数ulOptions：保留，设为0

参数samDesired：安全访问标记，也就是权限。主要用到的是KEY_READ。

参数phkResult：输出参数，保存将要打开键的句柄。

返回值：零（ERROR_SUCCESS）表示成功。其他任何值都代表一个错误代码。

举例说明：

看到没有，主键只有这五种情况~

假如我想要主键HKEY_LOCAL_MACHINE下面的Aria子键，那么，

参数hKey要设为HKEY_LOCAL_MACHINE

参数lpSubKey要设为"SOFTWARE\\ActivMedia Robotics\\Aria"

2. RegQueryInfoKey

RegQueryInfoKey(HKEY hkey, //要获取信息的句柄LPWSTR lpClass, <span style="white-space:pre"></span>//接受创建健时的Class字符串LPDWORD lpcbClass, <span style="white-space:pre"></span>//lpClass的长度LPDWORD lpReserved, <span style="white-space:pre"></span>//系统保留,指定为0LPDWORD lpcSubKeys,<span style="white-space:pre"></span>//子键数量LPDWORD lpcbMaxSubKeyLen, //子键中最长名称的长度LPDWORD lpcbMaxClassLen, //子键中最长Class字符串长度LPDWORD lpcVlaues, //键值数量LPDWORD lpcbMaxValueNameLen, //键值项中最长名称的长度LPDWORD lpcbMaxValueLen, //键值项数据最大长度LPDWORD lpcbSecurityDescriptor, //安全描述符长度FILETIME lpftLastWriteTime, //FILETIME结构,最后修改时间);

函数功能：获取键的统计信息，查看将要读取的字符串长度是否小于键值数据的最大长度。

参数太多，下面只说明重要的参数吧~

参数hkey：指定要获取信息的键句柄，键的打开方式中必须包括KEY_QUERY_VALUE。

参数lpcSubKeys：指向一个双字，用来返回键中的子键数量。

参数lpcbMaxSubKeyLen：指向一个双字，用来返回所有子键中最长的名称字符串长度，返回的长度不包括字符串结尾的0字符。

参数lpcVlaues：指向一个双字，用来返回键下面的键值项数量。

参数lpcbMaxValueNameLen：指向一个双字，用来返回所有键值项中最长的名称字符串长度，返回的长度不包括字符串结尾的0字符。

参数lpcbMaxValueLen：指向一个双字，用来返回所有键值数据的最大长度。

返回值：零（ERROR_SUCCESS）表示成功。其他任何值都代表一个错误代码。
如一个缓冲区的长度不够，不能容下返回的数据，则函数会返回ERROR_MORE_DATA

例子回头再举吧。。。

3. RegEnumValue

RegEnumValue(Long hkey, //被枚举的键句柄Long dwIndex, //子键索引编号String lpValueName, //键值名称Long lpcbValueName, //键值名称长度Long lpReserved, //系统保留,指定为0Long lpType, //键值数据类型Byte lpDate, //键值数据Long lpcbDate //键值数据长度);

函数功能：用来枚举指定项的值