FsRtlInsertPerFileContext 函式 (ntifs.h)

  • 發行項

FsRtlInsertPerFileContext 例程會將FSRTL_PER_FILE_CONTEXT對象與檔案的驅動程式指定內容對象產生關聯。

語法

NTSTATUS FsRtlInsertPerFileContext(
  [in] PVOID                   *PerFileContextPointer,
  [in] PFSRTL_PER_FILE_CONTEXT Ptr
);

參數

[in] PerFileContextPointer

文件系統運行時間連結庫 (FSRTL) 套件用來追蹤檔案內容的不透明指標指標。 若要從檔案物件擷取此指標，請使用 FsRtlGetPerFileContextPointer 宏。

[in] Ptr

驅動程式特定內容結構的指標。

傳回值

FsRtlInsertPerFileContext 例程會傳回STATUS_SUCCESS或適當的錯誤碼，例如：

傳回碼 Description
STATUS_INVALID_DEVICE_REQUEST
 基礎檔系統不支援篩選檔案內容。 您可以使用 FsRtlSupportsPerFileContexts 宏來檢查文件系統是否支援每個檔案內容物件。
STATUS_INSUFFICIENT_RESOURCES
 系統無法配置資源 (通常是記憶體) 。

備註

FsRtlGetPerFileContextPointer 宏會針對開啟的檔案傳回 FileContextSupportPointer 。

參數

FileObject

FILE_OBJECT

檔案物件的指標。

傳回值

PVOID

FsRtlGetPerFileContextPointer 宏會傳回文件系統運行時間連結庫 (FSRTL) 套件用來追蹤檔案內容的不透明指標。 如果文件系統不支援搭配檔案使用個別檔案內容物件，宏會傳回 NULL 。

FsRtlGetPerFileContextPointer 宏會傳回要傳遞至例程的指標，例如 FsRtlInsertPerFileContext、 FsRtlLookupPerFileContext 和 FsRtlRemovePerFileContext。

如需如何使用和建立內容對象的詳細資訊，請參閱 在舊版文件系統篩選驅動程式中追蹤 Per-File 內容。

規格需求

需求 值
最低支援的用戶端 Windows Vista
目標平台 Universal
標頭 ntifs.h (包含 FltKernel.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <=APC_LEVEL

另請參閱

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

在舊版文件系統篩選驅動程式中追蹤 Per-File 內容