FsRtlLogCcFlushError-Funktion (ntifs.h)
Die FsRtlLogCcFlushError-Routine protokolliert einen Fehler beim verzögerten Schreiben verloren und zeigt dem Benutzer ein Dialogfeld an.
Syntax
NTSTATUS FsRtlLogCcFlushError(
[in] PUNICODE_STRING FileName,
[in] PDEVICE_OBJECT DeviceObject,
[in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] NTSTATUS FlushError,
[in] ULONG Flags
);
Parameter
[in] FileName
Der Name der Datei, die nicht geleert werden konnte.
[in] DeviceObject
Ein Zeiger auf das Geräteobjekt, für das dieser Protokolleintrag abgelegt werden soll.
[in] SectionObjectPointer
Ein Zeiger auf das Abschnittsobjekt für die Datei, bei der die Leerung fehlgeschlagen ist.
[in] FlushError
Der vom Aufruf von CcFlushCache zurückgegebene Fehler.
[in] Flags
Ein Wert von 0 oder eine bitweise Kombination aus mindestens einem der folgenden Flags:
| Flag | Bedeutung |
|---|---|
| FSRTL_CC_FLUSH_ERROR_FLAG_NO_HARD_ERROR | Unterdrückt die Darstellung eines Informationsdialogfelds für den Benutzer. |
| FSRTL_CC_FLUSH_ERROR_FLAG_NO_LOG_ENTRY | Unterdrückt die Generierung eines Systemfehlerprotokolleintrags. |
Rückgabewert
Die FsRtlLogCcFlushError-Routine gibt STATUS_SUCCESS bei Erfolg oder einen anderen NTSTATUS-Wert zurück, z. B. STATUS_INSUFFICIENT_RESOURCES.
Hinweise
Sofern der Aufruf keine entsprechenden Flags enthält, verwendet die FsRtlLogCcFlushError-RoutineIoRaiseInformationalHardError , um dem Benutzer ein Dialogfeld anzuzeigen, einschließlich des spezifischen Fehlers und des Dateinamens, und verwendet IoWriteErrorLogEntry protokolliert den Fehler.
Wenn der gesamte Dateiname nicht in den Protokollpuffer passen kann, fügt die Routine eine Auslassungspunkte in den Dateinamen ein.
Wenn der Cache noch seiten enthält, die geändert wurden, ist der Fehler nicht schwerwiegend. Die Routine kehrt zum Aufrufer zurück, ohne einen Fehler zu protokollieren oder das Dialogfeld anzuzeigen.
Wenn der Fehler schwerwiegend ist, erhöht die Routine den verloren gegangenen verzögerten Schreibindikator im Prozessorsteuerungsblock (PRCB). Dieser Leistungsindikator kann zur Problembehandlung von verloren gegangenen schreibverzögerten Fehlern verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Universell |
| Header | ntifs.h (include FltKernel.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |