共用方式為


FsRtlLookupPerFileContext 函式 (ntifs.h)

FsRtlLookupPerFileContext 例程會傳回與指定檔案相關聯之 FSRTL_PER_FILE_CONTEXT 物件的指標。

語法

PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
  [in]           PVOID *PerFileContextPointer,
  [in, optional] PVOID OwnerId,
  [in, optional] PVOID InstanceId
);

參數

[in] PerFileContextPointer

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

[in, optional] OwnerId

篩選驅動程式配置的變數指標,可唯一識別每個檔案內容結構的擁有者。 此變數的格式為篩選驅動程式特定。 這個參數是選擇性的,但如果 InstanceId 為非NULL,則必須是非NULL

[in, optional] InstanceId

篩選驅動程式配置的變數指標,可用來區分相同篩選驅動程式所建立的每個檔案內容結構。 此變數的格式為篩選驅動程式特定。 這個參數是選擇性的。

傳回值

第一個FSRTL_PER_FILE_CONTEXT結構的指標,其符合 OwnerId,如果指定,則為 InstanceId,如果找不到相符專案,或文件系統不支援個別檔案內容,則為 NULL

言論

若未指定 OwnerIDInstanceId,篩選驅動程式就可以搜尋與檔案相關聯的第一個內容。

如果文件系統不支援個別檔案內容物件,則會傳回 NULL 。 使用 FsRtlSupportsPerFileContexts 巨集來判斷文件系統是否支援每個檔案內容物件。

要求

要求 價值
最低支援的用戶端 Windows Vista
目標平臺 普遍
標頭 ntifs.h (include FltKernel.h, Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

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