共用方式為

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或適當的錯誤碼，例如：

傳回碼 描述
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
目標平臺 普遍
標頭 ntifs.h （include FltKernel.h， Ntifs.h）
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL

另請參閱

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

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