山寨:不是最好的,是最适合我们的!欢迎体验山寨 中文版MSDN

Blog @ Blog

当华美的叶片落尽,生命的脉络才历历可见。 -- 聂鲁达

常用链接

统计

积分与排名

BBS

Blog

Web

最新评论

Win32 SDK注册表操作函数――RegQueryValue

RegQueryValue函数找回给定注册表键的默认值或未命名值所关联的数据。这个数据必须是一个以空字符结束的字符串。



这个函数与Windows 3.1兼容。基于Win32的应用程序应该使用RegQueryValueEx函数。

LONG RegQueryValue(
HKEY
hKey, // 要查询键的句柄
LPCTSTR lpSubKey,
// 要查询子键的名字
LPTSTR lpValue, // 返回字符串的缓存
PLONG lpcbValue // 接收返回字符串的大小
);


参数





hKey

当前打开的键或下列已确定保留句柄值:

HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
Windows NT:
HKEY_PERFORMANCE_DATA
Windows 95和Windows 98: HKEY_DYN_DATA



lpSubKey

指向要被找回默认值的hKey参数子键的名字的以空字符结束的字符串。如果这个参数为NULL或指向一个空字符串,那么这个函数找回能被hKey识别的默认值。

lpValue

指向与给定值的默认值相关联的以空字符串结束的字符串的缓存区。

如果lpValue是NULL并且lpcbValue不是NULL,这个函数返回ERROR_SUCCESS,并取回被lpcbData指定的变量缓存的大小(以字节为单位)。这个为值的数据缓存分配最好的途径。



lpcbValue

以字节为单位,指向lpData参数所指定地缓存区大小的变量。函数返回复制到lpData的数据大小的变量(包含结束字符)。

如果被lpData参数指定的缓存不够大,这个函数返回ERROR_MORE_DATA值,并取回被lpcbData指定的变量缓存的大小(以字节为单位)。

在所有的案例中,在lpcbValue返回的值的大小包含字符串的结束符。



返回值



如果调用成功,返回ERROR_SUCCESS。



如果调用失败,返回一个非零错误码(定义在WINERROR.H)。你可以使用带有FORMAT_MESSAGE_FROM_SYSTEM标记的FormatMessage函数获得错误的普通描述信息。



注意



能被hKey参数识别的键必须被带有KEY_QUERY_VALUE存取权限打开(KEY_READ存取权限包括KEY_QUERY_VALUE存取权限)。



如果这个函数的ANSI版本被使用(明确的调用RegQueryValueExA或在包含WINDOWS.H文件前不定义UNICODE),这个函数在复制它到lpValue参数给定的缓存区前,转换存贮的Unicode字符串到ANSI字符串。



快速信息



  Windows NT: 需要3.1或更高版本。
  Windows: 需要Windows 95或更高版本。
  Windows CE: 不支持。
  头文件: winreg.h。
  输入库: advapi32.lib。
  Unicode: 在Windows NT中作为Unicode和ANSI执行。



参见



Registry Overview, Registry Functions, RegEnumKey, RegEnumKeyEx, RegEnumValue, RegQueryInfoKey, RegQueryValueEx, RegSetValue, RegSetValueEx

posted on 2008-02-29 13:29 isabc 阅读(808) 评论(0)  编辑 收藏 引用 所属分类: VC Function


只有注册用户登录后才能发表评论。
【推荐】超50万行VC++源码: 大型组态工控、电力仿真CAD与GIS源码库
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理


广告信息(免费广告联系)

中文版MSDN:
欢迎体验