Partager via

MmForceSectionClosedEx, fonction (ntifs.h)

  • Article

La fonction MmForceSectionClosedEx examine les pointeurs d’objet de section. S’ils sont NULL, aucune autre action n’est effectuée et la valeur TRUE est retournée.

Si le pointeur de l’objet de section n’est pas NULL, le nombre de références de section et le nombre d’affichages cartographiques sont vérifiés. Si les deux nombres sont zéro, le segment associé au fichier est supprimé et le fichier fermé. Si l’un des nombres est différent de zéro, aucune action n’est effectuée et la valeur FALSE est retournée.

Syntaxe

BOOLEAN MmForceSectionClosedEx(
  PSECTION_OBJECT_POINTERS SectionObjectPointer,
  ULONG                    ForceCloseFlags
);

Paramètres

SectionObjectPointer

Spécifie un pointeur vers l’objet SECTION_OBJECT_POINTERS.

ForceCloseFlags

Contient des indicateurs qui indiquent si la section doit être marquée pour la fermeture ultérieure (dès que possible) dans l’événement où cette section ne peut pas être fermée maintenant en raison de références en attente.

Contient l’un des indicateurs suivants :

  • MM_FORCE_CLOSED_LATER_OK si la section doit être marquée pour fermeture immédiate si la section ne peut pas être fermée en raison de références en attente.

  • MM_FORCE_CLOSED_DATA forcer la fermeture de section de données.

  • MM_FORCE_CLOSED_IMAGE forcer la fermeture de section d’image.

Valeur de retour

Cette fonction retourne TRUE si le segment a été supprimé et si le fichier a été fermé ou qu’aucun segment n’a été trouvé. Si plusieurs types de segments sont spécifiés (données/image), ils doivent tous deux être supprimés avec succès pour que TRUE soit retourné.

Cette fonction retourne FALSE si le segment n’a pas été supprimé.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10 (version 1803)
plateforme cible Universel
d’en-tête ntifs.h
bibliothèque NtosKrnl.exe