Функция ORQueryInfoKey

Статья
06/13/2023

Извлекает сведения об указанном разделе реестра в автономном кусте реестра.

Синтаксис

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
);

Параметры

Дескриптор [в]

Дескриптор открытого раздела реестра в автономном кусте реестра.

lpClass [out, optional]

Указатель на буфер, получающий класс ключа. Этот параметр может принимать значение NULL.

lpcClass [in, out, optional]

Указатель на переменную, указывающую размер буфера, на который указывает параметр lpClass , в символах.

Размер должен включать завершающий символ NULL. При возврате функции эта переменная содержит размер строки класса, хранящейся в буфере. Возвращаемое число не включает завершающий символ NULL. Если буфер недостаточно велик, функция возвращает ERROR_MORE_DATA, а переменная содержит размер строки в символах без подсчета завершающего пустого символа.

Если lpClass имеет значение NULL, lpcClass может иметь значение NULL.

Если параметр lpClass является допустимым адресом, а параметр lpcClass — нет (например, если параметр lpcClass имеет значение NULL), функция возвращает ERROR_INVALID_PARAMETER.

lpcSubKeys [out, optional]

Указатель на переменную, получающую количество подразделов, содержащихся в указанном ключе. Этот параметр может принимать значение NULL.

lpcMaxSubKeyLen [out, optional]

Указатель на переменную, которая получает размер подраздела ключа с самым длинным именем в символах Юникода, не включая завершающий пустой символ. Этот параметр может принимать значение NULL.

lpcMaxClassLen [out, optional]

Указатель на переменную, которая получает размер самой длинной строки, указывающей класс подраздела, в символах Юникода. Возвращаемое число не включает завершающий символ NULL. Этот параметр может принимать значение NULL.

lpcValues [out, optional]

Указатель на переменную, получающую количество значений, связанных с ключом. Этот параметр может принимать значение NULL.

lpcMaxValueNameLen [out, optional]

Указатель на переменную, которая получает размер самого длинного имени значения ключа в символах Юникода. Размер не включает завершающий символ NULL. Этот параметр может принимать значение NULL.

lpcMaxValueLen [out, optional]

Указатель на переменную, которая получает размер самого длинного компонента данных из значений ключа в байтах. Этот параметр может принимать значение 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

Поделиться через