Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Um minifiltro chama FltRequestSecurityInfoOnCreateCompletion durante a pré-criação do 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 seguintes informações.
| 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. |
Valor de retorno
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. |
Observações
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 |
|---|---|
| de cliente com suporte mínimo | Windows 11, versão 24H2 |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |