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 內容。