FLT_PARAMETERS para IRP_MJ_QUERY_SECURITY unión

Artículo
02/07/2024

Componente de unión usado cuando se IRP_MJ_QUERY_SECURITY el campo MajorFunction de la estructura de FLT_IO_PARAMETER_BLOCK para la operación.

Sintaxis

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    SECURITY_INFORMATION    SecurityInformation;
    ULONG POINTER_ALIGNMENT Length;
    PVOID                   SecurityBuffer;
    PDML                    MdlAddress;
  } QuerySecurity;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Miembros

QuerySecurity: estructura que contiene los siguientes miembros.

SecurityInformation: puntero a un valor de SECURITY_INFORMATION proporcionado por el autor de la llamada que especifica la información de seguridad que se va a consultar. Uno de los siguientes:

Valor securityInformation	Significado
OWNER_SECURITY_INFORMATION	Se está consultando el identificador de propietario del objeto. Requiere acceso READ_CONTROL.
GROUP_SECURITY_INFORMATION	Se está consultando el identificador de grupo principal del objeto. Requiere acceso READ_CONTROL.
DACL_SECURITY_INFORMATION	Se está consultando la lista de control de acceso discrecional (DACL) del objeto. Requiere acceso READ_CONTROL.
SACL_SECURITY_INFORMATION	Se está consultando la ACL del sistema (SACL) del objeto. Requiere acceso ACCESS_SYSTEM_SECURITY.

Longitud: longitud, en bytes, del búfer al que apunta SecurityBuffer .
SecurityBuffer: puntero a un búfer de salida proporcionado por el autor de la llamada que recibe una copia del descriptor de seguridad del objeto especificado. El proceso de llamada debe tener derecho a ver los aspectos especificados del estado de seguridad del objeto. La estructura SECURITY_DESCRIPTOR se devuelve en formato auto relativo. Este miembro es opcional y puede ser NULL si se proporciona una MDL en MdlAddress. Vea Comentarios.
MdlAddress: dirección de una lista de descriptores de memoria (MDL) que describe el búfer al que apunta SecurityBuffer . Este miembro es opcional y puede ser NULL si se proporciona un búfer en SecurityBuffer. Vea Comentarios.

Comentarios

La estructura FLT_PARAMETERS para las operaciones de IRP_MJ_QUERY_SECURITY contiene los parámetros de una operación de información de seguridad de consulta basada en IRP representada por una estructura de datos de devolución de llamada (FLT_CALLBACK_DATA). Se encuentra en una estructura FLT_IO_PARAMETER_BLOCK .

Si se proporciona un búfer SecurityBuffer y MdlAddress , se recomienda que los minifiltros usen mdL. La memoria a la que Apunta SecurityBuffer es válida cuando se accede a una dirección de modo de usuario dentro del contexto del proceso de llamada, o si es una dirección del modo kernel.

Si un minifiltro cambia el valor de MdlAddress, después de su devolución de llamada posterior a la operación, el Administrador de filtros liberará el MDL almacenado actualmente en MdlAddress y restaurará el valor anterior de MdlAddress.

En Windows XP y versiones posteriores, el objeto al que apunta el miembro TargetFileObject de la estructura FLT_IO_PARAMETER_BLOCK puede representar un flujo de datos con nombre. Para obtener más información sobre los flujos de datos con nombre, consulte FILE_STREAM_INFORMATION.

IRP_MJ_QUERY_SECURITY es una operación basada en IRP.