操作注册表的API函数介绍(RegQueryValueEx:该函数用来查找一个给定类型和值的注册表项)

来源:互联网 发布:阿里云服务器升级硬盘 编辑:程序博客网 时间:2024/05/16 14:33

 RegQueryValueEx
该函数用来查找一个给定类型和值的注册表项,为了保证任何字符串以空结束符返回,请使用RegGetValue函数

LONG RegQueryValueEx(
  HKEY hKey,
  LPCTSTR lpValueName,
  LPDWORD lpReserved,
  LPDWORD lpType,
  LPBYTE lpData,
  LPDWORD lpcbData
);

参数
hKey
 入参,指向一个打开键的句柄。该键必须以KEY_QUERY_VALUE的安全级别打开。该参数可以是RegCreateKeyEx或者RegOpenKeyEx的返回值。也可以是以下预定义的值

  HKEY_CLASSES_ROOT
  HKEY_CURRENT_CONFIG
  HKEY_CURRENT_USER
  HKEY_LOCAL_MACHINE
  HKEY_PERFORMANCE_DATA
  HKEY_PERFORMANCE_NLSTEXT
  HKEY_PERFORMANCE_TEXT
  HKEY_USERS

 


lpValueName

 入参,指向一个以NULL结尾的字符串,该字符串保存了需要查询的键名。如果该参数为空或者该参数指向一个空字符串,该函数则会获取未命名的键或者默认键的类型和值

lpReserved
 保存,必须为NULL
lpType
 出参,表示查找到的键的类型,如果查找失败,该参数返回NULL
lpData
 出参,表示查找到的键值,如果查找失败,则返回空。

lpcbData
 出参并且是入参。标识键值的字节长度,包括结束符。

Return Values
 如果该函数成功,则返回ERROR_SUCCESS;