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

Статья
02/27/2024

Структура 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

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

KeyName

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

SourceFile

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

Flags

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

TrustClassObject

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

UserEvent

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

DesiredAccess

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

RootHandle

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

CallContext

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

ObjectContext

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

Reserved

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

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

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