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

Статья
03/08/2023

Является устаревшей. Начиная с Windows 7 используйте REG_CREATE_KEY_INFORMATION_V1, версию V1 этой структуры.

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

Синтаксис

typedef struct _REG_CREATE_KEY_INFORMATION {
  PUNICODE_STRING CompleteName;
  PVOID           RootObject;
  PVOID           ObjectType;
  ULONG           CreateOptions;
  PUNICODE_STRING Class;
  PVOID           SecurityDescriptor;
  PVOID           SecurityQualityOfService;
  ACCESS_MASK     DesiredAccess;
  ACCESS_MASK     GrantedAccess;
  PULONG          Disposition;
  PVOID           *ResultObject;
  PVOID           CallContext;
  PVOID           RootObjectContext;
  PVOID           Transaction;
  PVOID           Reserved;
} REG_CREATE_KEY_INFORMATION, REG_OPEN_KEY_INFORMATION, *PREG_CREATE_KEY_INFORMATION, *PREG_OPEN_KEY_INFORMATION;

Члены

CompleteName

Указатель на структуру UNICODE_STRING , содержащую путь к новому разделу реестра. Путь может быть как абсолютным, так и относительным. Если путь является абсолютным, эта структура содержит полный путь, начинающийся с символа "\". Для абсолютного пути член RootObject указывает раздел \REGISTRY , который является корневым каталогом дерева реестра. Если путь относительный, путь начинается с символа, отличного от "\", и относительно ключа, указанного в элементе RootObject .

RootObject

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

ObjectType

Элемент ObjectType зарезервирован для внутреннего использования. Драйверы не должны получать доступ к этому элементу.

CreateOptions

Побитовое ИЛИ флагов. Дополнительные сведения об этих флагах см. в параметре CreateOptions подпрограммыZwCreateKey .

Class

Указатель на структуру UNICODE_STRING , которая идентифицирует класс объекта ключа. Дополнительные сведения об этом элементе см. в параметре Class подпрограммы ZwCreateKey .

SecurityDescriptor

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

SecurityQualityOfService

Указатель на структуру SECURITY_QUALITY_OF_SERVICE , определенную в Winnt.h.

DesiredAccess

Маска доступа, заданная потоком, который пытается создать раздел реестра.

GrantedAccess

Маска доступа, указывающая права доступа, предоставленные потоку, который пытается создать раздел реестра. Дополнительные сведения об этом члене см. в разделе Примечания.

Disposition

Значение типа , указывающее, был ли создан раздел реестра. Дополнительные сведения об этом элементе см. в параметре Disposition подпрограммы ZwCreateKey и в следующем разделе Примечания.

ResultObject

Указатель на расположение, которое получает адрес объекта ключа, представляющего созданный раздел реестра. Дополнительные сведения об этом члене см. в разделе Примечания.

CallContext

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

RootObjectContext

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

Transaction

Указатель на объект транзакции, с которым выполняется попытка выполнения операции. Если этот член имеет значение NULL, операция выполняется в контексте, не являющемся транзакцией.

Reserved

Если этот член равен 1, можно безопасно привести эту структуру к типу REG_CREATE_KEY_INFORMATION_V1, который содержит дополнительные параметры.

Диспетчер конфигурации передает эту структуру в подпрограмму RegistryCallback каждый раз, когда поток пытается создать ключ, например, когда поток пользовательского режима вызывает RegCreateKey или RegCreateKeyEx или когда драйвер вызывает ZwCreateKey.

Если подпрограмма RegistryCallback драйвера возвращает STATUS_CALLBACK_BYPASS для уведомления RegNtPreCreateKeyEx , драйвер должен предоставить значения GrantedAccess, Disposition и ResultObject .

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