ORQueryInfoKey 函数
检索有关脱机注册表配置单元中指定注册表项的信息。
语法
DWORD ORQueryInfoKey(
_In_ ORHKEY Handle,
_Out_opt_ PWSTR lpClass,
_Inout_opt_ PDWORD lpcClass,
_Out_opt_ PDWORD lpcSubKeys,
_Out_opt_ PDWORD lpcMaxSubKeyLen,
_Out_opt_ PDWORD lpcMaxClassLen,
_Out_opt_ PDWORD lpcValues,
_Out_opt_ PDWORD lpcMaxValueNameLen,
_Out_opt_ PDWORD lpcMaxValueLen,
_Out_opt_ PDWORD lpcbSecurityDescriptor,
_Out_opt_ PFILETIME lpftLastWriteTime
);
参数
-
句柄 [in]
-
脱机注册表配置单元中打开的注册表项的句柄。
-
lpClass [out， 可选]
-
指向接收键类的缓冲区的指针。 此参数可以为 NULL。
-
lpcClass [in， out， optional]
-
指向变量的指针，该变量指定 lpClass 参数指向的缓冲区的大小（以字符为单位）。
大小应包括终止 null 字符。 函数返回时，此变量包含存储在缓冲区中的类字符串的大小。 返回的计数不包括终止 null 字符。 如果缓冲区不够大，函数将返回ERROR_MORE_DATA，变量包含字符串的大小（以字符为单位），而不计算终止 null 字符。
如果 lpClass 为 NULL， 则 lpcClass 可以为 NULL。
如果 lpClass 参数是有效的地址，但 lpcClass 参数不是 (例如，如果 lpcClass参数) 则 函数返回ERROR_INVALID_PARAMETER。
-
lpcSubKeys [out， 可选]
-
指向变量的指针，该变量接收指定键包含的子项数。 此参数可以为 NULL。
-
lpcMaxSubKeyLen [out， optional]
-
指向变量的指针，该变量接收具有最长名称的键子项的大小（以 Unicode 字符为单位），不包括终止 null 字符。 此参数可以为 NULL。
-
lpcMaxClassLen [out， optional]
-
指向变量的指针，该变量接收指定子项类的最长字符串的大小（以 Unicode 字符为单位）。 返回的计数不包括终止 null 字符。 此参数可以为 NULL。
-
lpcValues [out， optional]
-
指向变量的指针，该变量接收与键关联的值数。 此参数可以为 NULL。
-
lpcMaxValueNameLen [out， 可选]
-
指向变量的指针，该变量接收键的最长值名称的大小（以 Unicode 字符为单位）。 大小不包括终止 null 字符。 此参数可以为 NULL。
-
lpcMaxValueLen [out， 可选]
-
指向变量的指针，该变量接收键值中最长数据组件的大小（以字节为单位）。 此参数可以为 NULL。
-
lpcbSecurityDescriptor [out， optional]
-
指向变量的指针，该变量接收密钥的安全描述符的大小（以字节为单位）。 此参数可以为 NULL。
-
lpftLastWriteTime [out， optional]
-
指向接收上次写入时间 的 FILETIME 结构的指针。 此参数可以为 NULL。
函数设置 FILETIME 结构的成员，以指示上次修改键或其任何值条目的时间。
返回值
如果函数成功，则返回值为 ERROR_SUCCESS。
如果函数失败，则返回值为 Winerror.h 中定义的非零错误代码。 可以将 FormatMessage 函数与 FORMAT_MESSAGE_FROM_SYSTEM 标志一起使用，以获取错误的泛型说明。
如果 lpClass 缓冲区太小而无法接收类的名称，则函数将返回ERROR_MORE_DATA。
要求
| 要求 | 值 |
|---|---|
| 可再发行组件 |
Windows 脱机注册表库版本 1.0 或更高版本 |
| 标头 |
|
| DLL |
|
另请参阅