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 de objeto de seção do objeto de arquivo.

[in, optional] NewFileSize

Ponteiro para uma variável que especifica o tamanho para o qual o arquivo deve ser truncado.

Retornar valor

MmCanFileBeTruncated retornará TRUE se o arquivo puder ser truncado; Caso contrário, FALSE.

Comentários

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 for verdadeiro:

  • 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 por NewFileSize.

  • Um ou mais usuários mantêm referências à seção de dados do arquivo e NewFileSize<= o tamanho do arquivo atual.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Confira também

CcPurgeCacheSection

MmFlushImageSection