Função FsRtlLogCcFlushError (ntifs.h)

A rotina FsRtlLogCcFlushError registra um erro de gravação atrasada perdido e exibe uma caixa de diálogo para o usuário.

Sintaxe

NTSTATUS FsRtlLogCcFlushError(
  [in] PUNICODE_STRING          FileName,
  [in] PDEVICE_OBJECT           DeviceObject,
  [in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in] NTSTATUS                 FlushError,
  [in] ULONG                    Flags
);

Parâmetros

[in] FileName

O nome do arquivo que não pôde ser liberado.

[in] DeviceObject

Um ponteiro para o objeto do dispositivo no qual essa entrada de log deve ser arquivada.

[in] SectionObjectPointer

Um ponteiro para o objeto de seção do arquivo no qual a liberação falhou.

[in] FlushError

O erro retornado pela chamada para CcFlushCache.

[in] Flags

Um valor de 0 ou uma combinação bit a bit de um ou mais dos seguintes sinalizadores:

Sinalizador	Significado
FSRTL_CC_FLUSH_ERROR_FLAG_NO_HARD_ERROR	Suprime a apresentação de uma caixa de diálogo informativa para o usuário.
FSRTL_CC_FLUSH_ERROR_FLAG_NO_LOG_ENTRY	Suprime a geração de uma entrada de log de erros do sistema.

Retornar valor

A rotina FsRtlLogCcFlushError retorna STATUS_SUCCESS com êxito ou outro valor NTSTATUS, como STATUS_INSUFFICIENT_RESOURCES.

Comentários

A menos que a chamada inclua sinalizadores apropriados, a rotina FsRtlLogCcFlushError usa IoRaiseInformationalHardError para exibir uma caixa de diálogo para o usuário, incluindo o erro específico e FileName, e usa IoWriteErrorLogEntry registra o erro.

Se o FileName inteiro não puder caber dentro do buffer de log, a rotina inserirá uma reticências no nome do arquivo.

Se o cache ainda tiver páginas que foram modificadas, o erro não será fatal. A rotina retorna ao chamador sem registrar um erro ou exibir a caixa de diálogo.

Se o erro for fatal, a rotina incrementará o contador de gravação atrasado perdido no PRCB (bloco de controle do processador). Esse contador pode ser usado na solução de problemas de erros de gravação atrasados perdidos.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua FltKernel.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Confira também

CcFlushCache

IoRaiseInformationalHardError

IoWriteErrorLogEntry