FsRtlLogCcFlushError function (ntifs.h)
The FsRtlLogCcFlushError routine logs a lost delayed-write error and displays a dialog box to the user.
Syntax
NTSTATUS FsRtlLogCcFlushError(
[in] PUNICODE_STRING FileName,
[in] PDEVICE_OBJECT DeviceObject,
[in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] NTSTATUS FlushError,
[in] ULONG Flags
);
Parameters
[in] FileName
The name of the file that could not be flushed.
[in] DeviceObject
A pointer to the device object that this log entry should be filed against.
[in] SectionObjectPointer
A pointer to the section object for the file on which the flush failed.
[in] FlushError
The error returned by the call to CcFlushCache.
[in] Flags
A value of 0 or a bitwise combination of one or more of the following flags:
| Flag | Meaning |
|---|---|
| FSRTL_CC_FLUSH_ERROR_FLAG_NO_HARD_ERROR | Suppresses presentation of an informational dialog box to the user. |
| FSRTL_CC_FLUSH_ERROR_FLAG_NO_LOG_ENTRY | Suppresses generation of a system error log entry. |
Return value
The FsRtlLogCcFlushError routine returns STATUS_SUCCESS on success or another NTSTATUS value, such as STATUS_INSUFFICIENT_RESOURCES.
Remarks
Unless the call includes appropriate Flags, the FsRtlLogCcFlushError routine uses IoRaiseInformationalHardError to display a dialog box to the user, including the specific error and FileName, and uses IoWriteErrorLogEntry logs the error.
If the entire FileName cannot fit within the log buffer, the routine inserts an ellipsis into the file name.
If the cache still has pages that have been modified, the error is not fatal. The routine returns to the caller without logging an error or displaying the dialog box.
If the error is fatal, the routine increments the lost delayed write counter in the processor control block (PRCB). This counter can be used in troubleshooting lost delayed write errors.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Target Platform | Universal |
| Header | ntifs.h (include FltKernel.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |