Compartilhar via

Função FltRequestSecurityInfoOnCreateCompletion (fltkernel.h)

  • Artigo

Um minifiltro chama FltRequestSecurityInfoOnCreateCompletion durante a pré-criação de arquivo para solicitar que o sistema de arquivos armazene informações de segurança de arquivo para recuperação durante a pós-criação.

Sintaxe

NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
  PFLT_FILTER          Filter,
  PFLT_CALLBACK_DATA   Data,
  SECURITY_INFORMATION SecurityInformation
);

Parâmetros

Filter

Ponteiro de filtro opaco que identifica exclusivamente o driver de minifiltro.

Data

Ponteiro para os dados de retorno de chamada FLT_CALLBACK_DATA que representam a operação de criação de E/S.

SecurityInformation

SECURITY_INFORMATION valor que especifica as informações a serem definidas como uma combinação de uma ou mais das opções a seguir.

Valor Significado
OWNER_SECURITY_INFORMATION Indica que o identificador do proprietário do objeto deve ser definido. Requer acesso WRITE_OWNER.
GROUP_SECURITY_INFORMATION Indica que o identificador de grupo primário do objeto deve ser definido. Requer acesso WRITE_OWNER.
DACL_SECURITY_INFORMATION Indica que a DACL (lista de controle de acesso discricionário) do objeto deve ser definida. Requer acesso WRITE_DAC.
SACL_SECURITY_INFORMATION Indica que a ACL do sistema (SACL) do objeto deve ser definida. Requer acesso ACCESS_SYSTEM_SECURITY.

Retornar valor

FltRequestSecurityInfoOnCreateCompletion pode retornar um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS O sistema de arquivos armazenou com êxito as informações de segurança de arquivo solicitadas.
STATUS_INSUFFICIENT_RESOURCES FltRequestSecurityInfoOnCreateCompletion não pôde alocar memória suficiente para armazenar as informações de arquivo solicitadas.
STATUS_INVALID_PARAMETER_2 O objeto de dados de retorno de chamada fornecido não era uma operação de criação baseada em IRP.

Comentários

O minifiltro pode recuperar as informações do arquivo chamando FltRetrieveFileInfoOnCreateCompletionEx ou FltRetrieveFileInfoOnCreateCompletion durante a pós-criação. Normalmente, o desempenho de um minifiltro é melhor quando solicita e recupera informações de arquivo dessa maneira, em vez de consultar informações de arquivo posteriormente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11, versão 24H2
Cabeçalho fltkernel.h (inclua Fltkernel.h)

Confira também

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx