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 或更高版本
标头	Offreg.h
DLL	Offreg.dll

另请参阅

FILETIME

ORCreateKey

OROpenKey

ORDeleteKey