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


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

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

Синтаксис

typedef struct _REG_UNLOAD_KEY_INFORMATION {
  PVOID Object;
  PVOID UserEvent;
  PVOID CallContext;
  PVOID ObjectContext;
  PVOID Reserved;
} REG_UNLOAD_KEY_INFORMATION, *PREG_UNLOAD_KEY_INFORMATION;

Члены

Object

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

UserEvent

Указатель на объект события.

CallContext

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

ObjectContext

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

Reserved

Этот элемент зарезервирован для использования в будущем. Этот элемент определяется начиная с Windows Vista.

Комментарии

Эта структура используется подпрограммой RegistryCallback . Если параметр Argument1 для подпрограммы RegistryCallback имеет значение RegNtPreUnloadKey, параметр Argument2 является указателем на структуру REG_UNLOAD_KEY_INFORMATION .

Операционная система передает структуру REG_UNLOAD_KEY_INFORMATION подпрограмме RegistryCallback каждый раз, когда поток пытается выгрузить ключ, например, когда поток пользовательского режима вызывает функцию RegUnloadKey . В ответ на уведомление RegNtPreUnloadKey подпрограмма RegistryCallback должна освободить все ресурсы, ранее выделенные драйвером для использования с кустом перед выгрузкой куста.

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

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows Vista.
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)

См. также раздел

CmSetCallbackObjectContext

RegistryCallback