MmForceSectionClosedEx-Funktion (ntifs.h)

  • Artikel

Die Funktion MmForceSectionClosedEx untersucht die Abschnittsobjektzeiger. Wenn sie NULL sind, wird keine weitere Aktion ausgeführt, und der Wert TRUE wird zurückgegeben.

Wenn der Abschnittsobjektzeiger nicht NULL ist, werden die Anzahl des Abschnittsverweis und die Anzahl der Kartenansichten überprüft. Wenn beide Anzahlen 0 sind, wird das der Datei zugeordnete Segment gelöscht und die Datei geschlossen. Wenn eine der Anzahlen ungleich 0 ist, wird keine Aktion ausgeführt, und der Wert FALSE wird zurückgegeben.

Syntax

BOOLEAN MmForceSectionClosedEx(
  PSECTION_OBJECT_POINTERS SectionObjectPointer,
  ULONG                    ForceCloseFlags
);

Parameter

SectionObjectPointer

Gibt einen Zeiger auf das SECTION_OBJECT_POINTERS-Objekt an.

ForceCloseFlags

Enthält Flags, die angeben, ob der Abschnitt zum späteren Schließen markiert werden soll (so schnell wie möglich), falls dieser Abschnitt aufgrund ausstehender Verweise nicht geschlossen werden kann.

Enthält eines der folgenden Flags:

  • MM_FORCE_CLOSED_LATER_OK, wenn der Abschnitt zum sofortigen Schließen markiert werden soll, falls der Abschnitt aufgrund ausstehender Verweise nicht geschlossen werden kann.

  • MM_FORCE_CLOSED_DATA, um das Schließen des Datenabschnitts zu erzwingen.

  • MM_FORCE_CLOSED_IMAGE, um das Schließen des Bildabschnitts zu erzwingen.

Rückgabewert

Diese Funktion gibt TRUE zurück, wenn das Segment gelöscht wurde und die Datei geschlossen oder kein Segment gefunden wurde. Wenn mehrere Segmenttypen angegeben sind (Daten/Bild), müssen beide erfolgreich gelöscht werden, damit TRUE zurückgegeben wird.

Diese Funktion gibt FALSE zurück, wenn das Segment nicht gelöscht wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 (Version 1803)
Zielplattform Universell
Header ntifs.h
Bibliothek NtosKrnl.exe