Fonction MmForceSectionClosedEx (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 d’objet de section n’est pas NULL, le nombre de références de section et le nombre de vues cartographiques sont vérifiés. Si les deux nombres sont nuls, le segment associé au fichier est supprimé et le fichier est 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 fermeture ultérieurement (dès que possible) dans le cas 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 dans le cas où la section ne peut pas être fermée en raison de références en attente.

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

  • MM_FORCE_CLOSED_IMAGE pour forcer la fermeture de section d’image.

Valeur retournée

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

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 (version 1803)
Plateforme cible Universal
En-tête ntifs.h
Bibliothèque NtosKrnl.exe