RegOpenKeyEx FUNCTION

来源:互联网 发布:linux json 格式化 编辑:程序博客网 时间:2024/06/05 07:20

功能描述

  RegOpenKeyEx()
  函数功能描述:打开一个指定的注册表键

原型

  LONG RegOpenKeyEx(
  HKEY hKey, // 需要打开的主键的名称
  LPCTSTR lpSubKey, //需要打开的子键的名称
  DWORD ulOptions, // 保留,设为0
  REGSAM samDesired, // 安全访问标记,也就是权限
  PHKEY phkResult // 得到的将要打开键的句柄

参数

  hKey
  [输入] 当前打开或者以下预定义的键。
  HKEY_CLASSES_ROOT
  HKEY_CURRENT_CONFIG
  HKEY_CURRENT_USER
  HKEY_LOCAL_MACHINE
  HKEY_USERS
  Windows NT/2000/XP: HKEY_PERFORMANCE_DATA
  Windows 95/98/Me: HKEY_DYN_DATA
  lpSubKey
  [输入] 指向一个非中断字符串包含将要打开键的名称。如果参数设置为NULL 或者指向一个空字符串,过程将打开一个新的句柄由hKey参数确定的值。这种情况下,过程不会关闭先前已经打开的句柄。
  ulOptions
  保留,必须设置为 0
  samDesired
  [输入] 对指定键希望得到的访问权限的访问标记。 这个参数可以使下列值的联合。
  值 Meaning
  KEY_CREATE_LINK 许可创建一个符号连接
  KEY_CREATE_SUB_KEY 许可创建子键
  KEY_ENUMERATE_SUB_KEYS 许可列举子键
  KEY_EXECUTE 许可读访问
  KEY_NOTIFY 许可提供更改通知
  KEY_QUERY_VALUE 许可查询子键数据
  KEY_SET_VALUE 许可设置子键数据
  KEY_ALL_ACCESS 联合了 KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS,
  KEY_NOTIFY, KEY_CREATE_SUB_KEY, KEY_CREATE_LINK,
  KEY_SET_VALUE 访问权限并且加上所有的标准访问权限
  除了SYNCHRONIZE
  KEY_READ 联合了 STANDARD_RIGHTS_READ, KEY_QUERY_VALUE,
  KEY_ENUMERATE_SUB_KEYS,KEY_NOTIFY 访问权限
  KEY_WOW64_64KEY Windows XP: 使64位或者32位应用程序打开64位键
  KEY_WOW64_32KEY Windows XP: 使64位或者32位应用程序打开32位键
  KEY_WRITE 联合 STANDARD_RIGHTS_WRITE, KEY_SET_VALUE,
  KEY_CREATE_SUB_KEY访问权限
  phkResult
  [输出] 指向一个被打开键返回的句柄的指针。当不再需要句柄,必须调用 RegCloseKey 关闭它。
  返回值:
  如果过程执行成功,返回值是 ERROR_SUCCESS。
  如果功能失败,返回一个非零值,错误码在 Winerror.h 定义。可以使用 FormatMessage 函数 和 FORMAT_MESSAGE_FROM_SYSTEM 标记获得一个分类的错误描述。
原创粉丝点击