FsRtlLogCcFlushError, fonction (ntifs.h)

Article
12/21/2024

La routine FsRtlLogCcFlushError journalise une erreur d’écriture différée perdue et affiche une boîte de dialogue à l’utilisateur.

Syntaxe

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

Paramètres

[in] FileName

Nom du fichier qui n’a pas pu être vidé.

[in] DeviceObject

Pointeur vers l’objet d’appareil sur lequel cette entrée de journal doit être déposée.

[in] SectionObjectPointer

Pointeur vers l’objet de section du fichier sur lequel le vidage a échoué.

[in] FlushError

Erreur retournée par l’appel à CcFlushCache.

[in] Flags

Valeur 0 ou combinaison au niveau du bit d’un ou plusieurs indicateurs suivants :

Drapeau	Signification
FSRTL_CC_FLUSH_ERROR_FLAG_NO_HARD_ERROR	Supprime la présentation d’une boîte de dialogue informationnelle à l’utilisateur.
FSRTL_CC_FLUSH_ERROR_FLAG_NO_LOG_ENTRY	Supprime la génération d’une entrée de journal des erreurs système.

Valeur de retour

La routine FsRtlLogCcFlushError retourne STATUS_SUCCESS sur la réussite ou une autre valeur NTSTATUS, telle que STATUS_INSUFFICIENT_RESOURCES.

Remarques

Sauf si l’appel inclut lesindicateurs appropriés, la routine FsRtlLogCcFlushError utilise IoRaiseInformationalHardError pour afficher une boîte de dialogue à l’utilisateur, y compris l’erreur spécifique et FileName, et utilise IoWriteErrorLogEntry journalise l’erreur.

Si l’intégralité FileName ne peut pas s’adapter à la mémoire tampon du journal, la routine insère des points de suspension dans le nom de fichier.

Si le cache a toujours des pages qui ont été modifiées, l’erreur n’est pas irrécupérable. La routine retourne à l’appelant sans journaliser une erreur ou afficher la boîte de dialogue.

Si l’erreur est irrécupérable, la routine incrémente le compteur d’écriture retardé perdu dans le bloc de contrôle du processeur (PRCB). Ce compteur peut être utilisé pour résoudre les erreurs d’écriture différées perdues.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
plateforme cible	Universel
d’en-tête	ntifs.h (include FltKernel.h, Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Voir aussi

ccFlushCache

IoRaiseInformationalHardError

IoWriteErrorLogEntry

Partager via