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

Мақала
02/07/2025

Структура REG_QUERY_KEY_SECURITY_INFORMATION получает сведения о безопасности для объекта раздела реестра.

Синтаксис

C++

typedef struct _REG_QUERY_KEY_SECURITY_INFORMATION {
  PVOID                 Object;
  PSECURITY_INFORMATION SecurityInformation;
  PSECURITY_DESCRIPTOR  SecurityDescriptor;
  PULONG                Length;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_QUERY_KEY_SECURITY_INFORMATION, *PREG_QUERY_KEY_SECURITY_INFORMATION;

Члены

Object

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

SecurityInformation

Указатель на значение типа SECURITY_INFORMATION, определяющее тип запрашиваемой информации безопасности.

SecurityDescriptor

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

Length

Длина в байтах структуры SECURITY_DESCRIPTOR, на которую securityDescriptor.

CallContext

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

ObjectContext

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

Reserved

Этот элемент зарезервирован для дальнейшего использования. Этот элемент определен для Windows Vista и более поздних версий операционной системы Windows.

Замечания

Система передает структуру REG_QUERY_KEY_SECURITY_INFORMATIONRegistryCallback каждый раз, когда поток пытается запрашивать сведения о безопасности ключа, например, когда драйвер вызывает ZwQuerySecurityObject.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows Vista и более поздних версиях операционной системы Windows.
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)