FsRtlLogCcFlushError 函式 (ntifs.h)
FsRtlLogCcFlushError 例程會記錄遺失延遲寫入錯誤,並向使用者顯示對話方塊。
語法
NTSTATUS FsRtlLogCcFlushError(
[in] PUNICODE_STRING FileName,
[in] PDEVICE_OBJECT DeviceObject,
[in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] NTSTATUS FlushError,
[in] ULONG Flags
);
參數
[in] FileName
無法排清的檔名。
[in] DeviceObject
應該針對此記錄專案提出之裝置物件的指標。
[in] SectionObjectPointer
清除失敗之檔案之區段物件的指標。
[in] FlushError
[in] Flags
值 0 或下列一或多個旗標的位元組合:
旗 | 意義 |
---|---|
FSRTL_CC_FLUSH_ERROR_FLAG_NO_HARD_ERROR | 隱藏向用戶呈現資訊對話方塊。 |
FSRTL_CC_FLUSH_ERROR_FLAG_NO_LOG_ENTRY | 抑制產生系統錯誤記錄檔專案。 |
傳回值
FsRtlLogCcFlushError 例程會傳回成功或其他 NTSTATUS 值STATUS_SUCCESS,例如STATUS_INSUFFICIENT_RESOURCES。
言論
除非呼叫包含適當的 旗標,否則 FsRtlLogCcFlushError 例程會使用 IoRaiseInformationalHardError 向使用者顯示對話方塊,包括特定的錯誤和 FileName,並使用 IoWriteErrorLogEntry 記錄錯誤。
如果整個 FileName 無法放入記錄緩衝區內,例程會將省略號插入檔名中。
如果快取仍有已修改的頁面,則錯誤並不嚴重。 例程會傳回給呼叫端,而不記錄錯誤或顯示對話方塊。
如果錯誤是致命的,則例程會在處理器控制區塊中遞增遺失的延遲寫入計數器(PRCB)。 此計數器可用於針對遺失延遲寫入錯誤進行疑難解答。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
目標平臺 | 普遍 |
標頭 | ntifs.h (include FltKernel.h, Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |