FsRtlLogCcFlushError-Funktion (ntifs.h)

Artikel
12/22/2024

Die FsRtlLogCcFlushError Routine protokolliert einen Fehler beim verzögerten Schreiben 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, gegen das dieser Protokolleintrag abgelegt werden soll.

[in] SectionObjectPointer

Ein Zeiger auf das Abschnittsobjekt für die Datei, für die das Leeren fehlgeschlagen ist.

[in] FlushError

Der vom Aufruf von CcFlushCachezurückgegebene Fehler.

[in] Flags

Ein Wert von 0 oder eine bitweise Kombination aus einer oder mehreren der folgenden Flags:

Flagge	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 einem anderen NTSTATUS-Wert zurück, z. B. STATUS_INSUFFICIENT_RESOURCES.

Bemerkungen

Sofern der Aufruf nicht die entsprechenden Flagsenthält, verwendet die FsRtlLogCcFlushError Routine IoRaiseInformationalHardError, um dem Benutzer ein Dialogfeld anzuzeigen, einschließlich des spezifischen Fehlers und FileName-und verwendet IoWriteErrorLogEntry protokolliert den Fehler.

Wenn der gesamte FileName- 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 verlorenen verzögerten Schreibzähler im Prozessorsteuerungsblock (PRCB). Dieser Leistungsindikator kann bei der Problembehandlung bei verlorenen verzögerten Schreibfehlern verwendet werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Universal
Header-	ntifs.h (include FltKernel.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL

Siehe auch

CcFlushCache-

IoRaiseInformationalHardError

IoWriteErrorLogEntry-

Freigeben über