структура REG_LOAD_KEY_INFORMATION (wdm.h)

Статья
02/07/2025

Структура REG_LOAD_KEY_INFORMATION содержит сведения о загрузочном кусте реестра.

Синтаксис

typedef struct _REG_LOAD_KEY_INFORMATION {
  PVOID           Object;
  PUNICODE_STRING KeyName;
  PUNICODE_STRING SourceFile;
  ULONG           Flags;
  PVOID           TrustClassObject;
  PVOID           UserEvent;
  ACCESS_MASK     DesiredAccess;
  PHANDLE         RootHandle;
  PVOID           CallContext;
  PVOID           ObjectContext;
  PVOID           Reserved;
} REG_LOAD_KEY_INFORMATION, *PREG_LOAD_KEY_INFORMATION;

Члены

Object

Указатель на объект раздела реестра для корневого ключа hive, который будет загружен.

KeyName

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

SourceFile

Указатель на структуру UNICODE_STRING, содержащую имя пути файла, содержащего сведения о реестре, загруженные.

Flags

Зарезервировано для использования системы.

TrustClassObject

Зарезервировано для использования системы.

UserEvent

Указатель на объект события, сигналивный при выгрузке куста.

DesiredAccess

Маска доступа, указанная потоком, который пытается загрузить раздел реестра. Дополнительные сведения об этой маске доступа см. в описании параметра DesiredAccess подпрограммы ZwCreateKey.

RootHandle

Необязательный указатель на расположение, которое получает дескриптор к корню загружаемого куста. Этот элемент может быть неNULL, если загружается hive приложения. Во всех остальных случаях этот элемент должен быть null.

CallContext

Необязательные сведения о контексте, определяемые драйвером, могут предоставлять RegistryCallback подпрограмму.

ObjectContext

Указатель на определяемые драйвером контекстные сведения о том, что драйвер связан с объектом реестра путем вызова подпрограммы cmSetCallbackObjectContext.

Reserved

Зарезервировано для использования системы.

Замечания

Операционная система передает структуру REG_LOAD_KEY_INFORMATION в подпрограмму RegistryCallback каждый раз, когда поток пользовательского режима вызывает RegLoadKey для загрузки куста реестра.

Дополнительные сведения о операциях фильтрации реестра см. в вызовов реестра.