MmForceSectionClosedEx 函式 (ntifs.h)

  • 發行項

MmForceSectionClosedEx 函式會檢查區段對象指標。 如果是 NULL，則不會採取進一步的動作，並傳回 TRUE 值。

如果區段對象指標不是 NULL，則會檢查區段參考計數和地圖檢視計數。 如果這兩個計數都是零，則會刪除與檔案相關聯的區段，並關閉檔案。 如果其中一個計數為非零，則不會採取任何動作，並傳回 FALSE 值。

語法

BOOLEAN MmForceSectionClosedEx(
  PSECTION_OBJECT_POINTERS SectionObjectPointer,
  ULONG                    ForceCloseFlags
);

參數

SectionObjectPointer

指定 SECTION_OBJECT_POINTERS 物件的指標。

ForceCloseFlags

包含旗標，指出區段是否應該標示為稍後關閉， () 儘快關閉，因為未完成的參考，所以無法立即關閉此區段。

包含下列其中一個旗標：

  • MM_FORCE_CLOSED_LATER_OK如果區段應該標示為立即關閉，但因為未處理的參考而無法關閉該區段。

  • MM_FORCE_CLOSED_DATA強制關閉數據區段。

  • MM_FORCE_CLOSED_IMAGE強制影像區段關閉。

傳回值

如果刪除區段且檔案已關閉或找不到區段，則此函式會傳回 TRUE。 如果指定多個區段類型 (數據/影像) ，則必須成功刪除兩者，才能傳回 TRUE。

如果未刪除區段，此函式會傳回 FALSE。

規格需求

需求 值
最低支援的用戶端 Windows 10 (版本 1803)
目標平台 Universal
標頭 ntifs.h
程式庫 NtosKrnl.exe