shRegQueryInfoUSKeyA 函数 (shlwapi.h)
检索用户特定的子树 (HKEY_CURRENT_USER 或HKEY_LOCAL_MACHINE) 中指定注册表子项的相关信息。
语法
LSTATUS SHRegQueryInfoUSKeyA(
[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 的指针。
[out, optional] pcValues
类型: LPDWORD
指向 DWORD 的指针,该 DWORD 接收指定键下的值数。
[out, optional] pcchMaxValueNameLen
类型: LPDWORD
指向接收最大值名称中字符数的 DWORD 的指针。
[in] enumRegFlags
类型: SHREGENUM_FLAGS
SHREGENUM_FLAGS之一,指定应在其中执行查询的基键。
返回值
类型: LSTATUS
如果成功,则返回ERROR_SUCCESS,否则返回 Winerror.h 中定义的非零错误代码。 可以将 FormatMessage 函数与 FORMAT_MESSAGE_FROM_SYSTEM 标志一起使用,以检索错误的文本说明。
注解
注意
shlwapi.h 标头将 SHRegQueryInfoUSKey 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | shlwapi.h |
Library | Shlwapi.lib |
DLL | Shlwapi.dll (4.71 或更高版本) |