Função MmCanFileBeTruncated (ntifs.h)
A rotina MmCanFileBeTruncated verifica se um arquivo pode ser truncado.
Sintaxe
BOOLEAN MmCanFileBeTruncated(
[in] PSECTION_OBJECT_POINTERS SectionPointer,
[in, optional] PLARGE_INTEGER NewFileSize
);
Parâmetros
[in] SectionPointer
Ponteiro para uma estrutura que contém os ponteiros do objeto de seção do objeto de arquivo.
[in, optional] NewFileSize
Ponteiro para uma variável que especifica o tamanho em bytes aos quais o arquivo deve ser truncado. Se esse parâmetro for NULL, um comprimento de zero será assumido e MmCanFileBeTruncated verificará se todo o arquivo pode ser truncado.
Valor de retorno
MmCanFileBeTruncated retornará TRUE se o arquivo puder ser truncado; FALSE caso contrário.
Observações
MmCanFileBeTruncated sempre deve ser chamado antes que um arquivo seja truncado.
Um arquivo não pode ser truncado (e MmCanFileBeTruncated retornará FALSE) se qualquer um dos seguintes forem verdadeiros:
Existe uma seção de imagem para o arquivo.
Há uma ou mais investigações de gravação pendentes na seção de dados do arquivo.
Há uma exibição mapeada da seção de dados do arquivo dentro do intervalo de truncamento determinado pelo NewFileSize.
Um ou mais usuários têm referências à seção de dados do arquivo e NewFileSize<= o tamanho do arquivo atual.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino |
Universal |
| cabeçalho | ntifs.h (inclua Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL |
NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |