Função FltRetrieveFileInfoOnCreateCompletion (fltkernel.h)
FltRetrieveFileInfoOnCreateCompletion recupera as informações de arquivo solicitadas durante a criação da postagem de arquivo. Use FltRetrieveFileInfoOnCreateCompletionEx para obter um código NTSTATUS junto com as informações solicitadas.
Sintaxe
PVOID FLTAPI FltRetrieveFileInfoOnCreateCompletion(
[in] PFLT_FILTER Filter,
[in] PFLT_CALLBACK_DATA Data,
[in] ULONG InfoClass,
[out] PULONG Size
);
Parâmetros
[in] Filter
Ponteiro de filtro opaco que identifica exclusivamente o driver de minifiltro.
[in] Data
Ponteiro para os dados de retorno de chamada FLT_CALLBACK_DATA que representam a operação de E/S.
[in] InfoClass
Sinalizador que indica o tipo de informação a ser retornado. Observe que os sinalizadores não podem ser combinados. Pode ser um dos seguintes valores:
| Bandeira | Significado |
|---|---|
| QoCFileStatInformation (0x00000001) | O sistema de arquivos retornará informações de estatística de arquivo em uma estrutura QUERY_ON_CREATE_FILE_STAT_INFORMATION. |
| QoCFileLxInformation (0x00000002) | O sistema de arquivos retornará informações estendidas semelhantes ao Linux em uma estrutura QUERY_ON_CREATE_FILE_LX_INFORMATION. |
| QoCFileEaInformation (0x00000004) | O sistema de arquivos retornará atributos estendidos (EA) em uma estrutura QUERY_ON_CREATE_EA_INFORMATION. |
| QoCFileUsnInformation (0x00000008) | O sistema de arquivos retornará informações usn em uma estrutura de QUERY_ON_CREATE_USN_INFORMATION. |
| QoCFileSecurityInformation (0x00000010) | O sistema de arquivos retornará informações de segurança de arquivo em uma estrutura de QUERY_ON_CREATE_SECURITY_INFORMATION. |
[out] Size
Ponteiro para um ULONG que especifica o tamanho, em bytes, do buffer que essa função retorna.
Valor de retorno
FltRetrieveFileInfoOnCreateCompletion retorna um ponteiro para um buffer com as informações de arquivo solicitadas. A estrutura dentro do buffer é determinada pelo valor de InfoClass. Se o sistema de arquivos processar a solicitação, mas não encontrar as informações de arquivo solicitadas, esse parâmetro será definido como NULL.
Observações
Um minifiltro deve chamar FltRequestFileInfoOnCreateCompletion durante a pré-criação do arquivo para especificar quais informações de arquivo o sistema de arquivos deve rastrear.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | fltkernel.h |