RegQueryInfoKeyW 函数（winreg.h）

项目
11/20/2024

检索有关指定注册表项的信息。

语法

LSTATUS RegQueryInfoKeyW(
  [in]                HKEY      hKey,
  [out, optional]     LPWSTR    lpClass,
  [in, out, optional] LPDWORD   lpcchClass,
                      LPDWORD   lpReserved,
  [out, optional]     LPDWORD   lpcSubKeys,
  [out, optional]     LPDWORD   lpcbMaxSubKeyLen,
  [out, optional]     LPDWORD   lpcbMaxClassLen,
  [out, optional]     LPDWORD   lpcValues,
  [out, optional]     LPDWORD   lpcbMaxValueNameLen,
  [out, optional]     LPDWORD   lpcbMaxValueLen,
  [out, optional]     LPDWORD   lpcbSecurityDescriptor,
  [out, optional]     PFILETIME lpftLastWriteTime
);

参数

[in] hKey

打开的注册表项的句柄。密钥必须使用KEY_QUERY_VALUE访问权限打开。有关详细信息，请参阅注册表项安全和访问权限。

此句柄由 RegCreateKeyEx、RegCreateKeyTransacted、RegOpenKeyEx或 RegOpenKeyTransacted 函数返回。它也可以是以下预定义键之一：


   HKEY_CLASSES_ROOT
   HKEY_CURRENT_CONFIG
   HKEY_CURRENT_USER
   HKEY_LOCAL_MACHINE
   HKEY_PERFORMANCE_DATA
   HKEY_USERS

[out, optional] lpClass

指向接收密钥的用户定义类的缓冲区的指针。此参数可以 NULL。

[in, out, optional] lpcchClass

指向变量的指针，该变量指定 lpClass 参数所指向的缓冲区的大小（以字符为单位）。

大小应包括终止 null 字符。函数返回时，此变量包含存储在缓冲区中的类字符串的大小。返回的计数不包括终止 null 字符。如果缓冲区不够大，则该函数将返回ERROR_MORE_DATA，并且变量包含字符串的大小（以字符为单位）而不计算终止 null 字符。

如果 lpClassNULL，lpcClass 可以 NULL。

如果 lpClass 参数是有效的地址，但 lpcClass 参数不是，例如，它 NULL，则函数将返回ERROR_INVALID_PARAMETER。

lpReserved

此参数是保留的，必须 NULL。

[out, optional] lpcSubKeys

指向接收指定键包含的子项数的变量的指针。此参数可以 NULL。

[out, optional] lpcbMaxSubKeyLen

指向一个变量的指针，该变量接收名称最长的键子项的大小（以 Unicode 字符为单位），不包括终止 null 字符。此参数可以 NULL。

[out, optional] lpcbMaxClassLen

指向一个变量的指针，该变量接收指定 Unicode 字符中子项类的最长字符串的大小。返回的计数不包括终止 null 字符。此参数可以 NULL。

[out, optional] lpcValues

指向接收与键关联的值的变量的指针。此参数可以 NULL。

[out, optional] lpcbMaxValueNameLen

指向一个变量的指针，该变量接收键最长值名称的大小（以 Unicode 字符为单位）。大小不包括终止 null 字符。此参数可以 NULL。

[out, optional] lpcbMaxValueLen

指向一个变量的指针，该变量接收键值中最长数据组件的大小（以字节为单位）。此参数可以 NULL。

[out, optional] lpcbSecurityDescriptor

指向接收密钥安全描述符大小的变量的指针，以字节为单位。此参数可以 NULL。

[out, optional] lpftLastWriteTime

指向接收上次写入时间的 FILETIME 结构的指针。此参数可以 NULL。

该函数设置 FILETIME 结构的成员，以指示上次修改键或其任何值项的时间。

返回值

如果函数成功，则返回值ERROR_SUCCESS。

如果函数失败，则返回值为系统错误代码。

如果 lpClass 缓冲区太小，无法接收类的名称，则函数将返回ERROR_MORE_DATA。

言论

注意

winreg.h 标头将 RegQueryInfoKey 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	winreg.h （包括 Windows.h）
库	Advapi32.lib
DLL	Advapi32.dll