Compartilhar via


FLT_PARAMETERS para união IRP_MJ_QUERY_SECURITY

Componente union usado quando o campo MajorFunction da estrutura FLT_IO_PARAMETER_BLOCK para a operação é IRP_MJ_QUERY_SECURITY.

Sintaxe

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

Membros

  • QuerySecurity: estrutura que contém os seguintes membros.

  • SecurityInformation: ponteiro para um valor de SECURITY_INFORMATION fornecido pelo chamador que especifica as informações de segurança a serem consultadas. Um dos seguintes:

    Valor de SecurityInformation Significado
    OWNER_SECURITY_INFORMATION O identificador de proprietário do objeto está sendo consultado. Requer acesso READ_CONTROL.
    GROUP_SECURITY_INFORMATION O identificador de grupo primário do objeto está sendo consultado. Requer acesso READ_CONTROL.
    DACL_SECURITY_INFORMATION A DACL (lista de controle de acesso discricionário) do objeto está sendo consultada. Requer acesso READ_CONTROL.
    SACL_SECURITY_INFORMATION A ACL do sistema (SACL) do objeto está sendo consultada. Requer acesso ACCESS_SYSTEM_SECURITY.
  • Comprimento: comprimento, em bytes, do buffer para o qual o SecurityBuffer aponta.

  • SecurityBuffer: ponteiro para um buffer de saída fornecido pelo chamador que recebe uma cópia do descritor de segurança do objeto especificado. O processo de chamada deve ter o direito de exibir os aspectos especificados do status de segurança do objeto. A estrutura SECURITY_DESCRIPTOR é retornada no formato auto-relativo. Esse membro é opcional e pode ser NULL se um MDL for fornecido em MdlAddress. Veja os Comentários.

  • MdlAddress: endereço de uma MDL (lista de descritores de memória) que descreve o buffer para o qual o SecurityBuffer aponta. Esse membro é opcional e pode ser NULL se um buffer for fornecido no SecurityBuffer. Veja os Comentários.

Comentários

A estrutura FLT_PARAMETERS para operações de IRP_MJ_QUERY_SECURITY contém os parâmetros de uma operação de consulta-segurança-informação baseada em IRP representada por uma estrutura de dados de retorno de chamada (FLT_CALLBACK_DATA). Ele está contido em uma estrutura FLT_IO_PARAMETER_BLOCK .

Se um buffer SecurityBuffer e MdlAddress for fornecido, é recomendável que os minifiltros usem o MDL. A memória para a qual o SecurityBuffer aponta é válida quando é um endereço de modo de usuário sendo acessado no contexto do processo de chamada ou se é um endereço no modo kernel.

Se um minifiltro alterar o valor de MdlAddress, após o retorno de chamada pós-operação, o Gerenciador de Filtros liberará o MDL armazenado atualmente em MdlAddress e restaurará o valor anterior de MdlAddress.

No Windows XP e posterior, o objeto para o qual o membro TargetFileObject do FLT_IO_PARAMETER_BLOCK estrutura aponta pode representar um fluxo de dados nomeado. Para obter mais informações sobre fluxos de dados nomeados, consulte FILE_STREAM_INFORMATION.

IRP_MJ_QUERY_SECURITY é uma operação baseada em IRP.

Requisitos

Tipo de Requisito Requisito
parâmetro Fltkernel.h (inclua Fltkernel.h)

Confira também

FILE_STREAM_INFORMATION

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FLT_PARAMETERS

IRP_MJ_QUERY_SECURITY

SECURITY_DESCRIPTOR

SECURITY_INFORMATION