REG_QUERY_KEY_SECURITY_INFORMATION structure (wdm.h)
The REG_QUERY_KEY_SECURITY_INFORMATION structure receives security information for a registry key object.
Syntax
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;
Members
Object
A pointer to the registry key object for the key whose security information is being retrieved.
SecurityInformation
A pointer to a SECURITY_INFORMATION-typed value that identifies the type of security information that is being requested.
SecurityDescriptor
A pointer to a SECURITY_DESCRIPTOR structure that receives security information for the key object.
Length
The length, in bytes of the SECURITY_DESCRIPTOR structure that SecurityDescriptor points to.
CallContext
Optional driver-defined context information that the driver's RegistryCallback routine can supply. This member is defined for Windows Vista and later versions of the Windows operating system.
ObjectContext
A pointer to driver-defined context information that the driver has associated with a registry object by calling CmSetCallbackObjectContext. This member is defined for Windows Vista and later versions of the Windows operating system.
Reserved
This member is reserved for future use. This member is defined for Windows Vista and later versions of the Windows operating system.
Remarks
The system passes the REG_QUERY_KEY_SECURITY_INFORMATION structure to the RegistryCallback routine every time a thread attempts to query a key's security information—for example, when a driver calls ZwQuerySecurityObject.
For more information about registry filtering operations, see Filtering Registry Calls.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available on Windows Vista and later versions of the Windows operating system. |
| Header | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |