SHRegQueryInfoUSKeyW 函数 (shlwapi.h)

检索用户特定的子树 (HKEY_CURRENT_USER 或HKEY_LOCAL_MACHINE) 中指定注册表子项的信息。

语法

LSTATUS SHRegQueryInfoUSKeyW(
  [in]            HUSKEY          hUSKey,
  [out, optional] LPDWORD         pcSubKeys,
  [out, optional] LPDWORD         pcchMaxSubKeyLen,
  [out, optional] LPDWORD         pcValues,
  [out, optional] LPDWORD         pcchMaxValueNameLen,
  [in]            SHREGENUM_FLAGS enumRegFlags
);

参数

[in] hUSKey

类型： HUSKEY

当前打开的注册表子项的句柄。 子项必须已使用KEY_SET_VALUE访问权限打开。 有关详细信息，请参阅 注册表项安全和访问权限。

可以通过 SHRegOpenUSKey 函数获取此句柄。

[out, optional] pcSubKeys

类型： LPDWORD

指向 DWORD 的指针，该 DWORD 接收指定键下的子项数。

[out, optional] pcchMaxSubKeyLen

类型： LPDWORD

指向 DWORD 的指针，该 DWORD 接收最大子项名称中的字符数。

[out, optional] pcValues

类型： LPDWORD

指向 DWORD 的指针，该 DWORD 接收指定键下的值数。

[out, optional] pcchMaxValueNameLen

类型： LPDWORD

指向接收最大值名称中字符数的 DWORD 的指针。

[in] enumRegFlags

类型： SHREGENUM_FLAGS

SHREGENUM_FLAGS之一，指定应在其中执行查询的基键。

返回值

类型： LSTATUS

如果成功，则返回ERROR_SUCCESS，否则返回 Winerror.h 中定义的非零错误代码。 可以使用带有 FORMAT_MESSAGE_FROM_SYSTEM 标志的 FormatMessage 函数来检索错误的文本说明。

注解

注意

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

要求

要求	值
最低受支持的客户端	Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	shlwapi.h
Library	Shlwapi.lib
DLL	Shlwapi.dll (版本 4.71 或更高版本)