共用方式為


FsRtlInsertPerStreamContext 函式 (ntifs.h)

FsRtlInsertPerStreamContext 例程會將文件系統篩選驅動程式的每個數據流內容結構與檔案數據流產生關聯。

語法

NTSTATUS FsRtlInsertPerStreamContext(
       PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
  [in] PFSRTL_PER_STREAM_CONTEXT  Ptr
);

參數

PerStreamContext

檔案數據流FSRTL_ADVANCED_FCB_HEADER結構的指標。 若要從檔案物件取得此指標,請使用 FsRtlGetPerStreamContextPointer 巨集。

[in] Ptr

篩選驅動程式已配置和初始化之FSRTL_PER_STREAM_CONTEXT結構的指標。 若要初始化這個結構,請使用 FsRtlInitPerStreamContext 巨集。

傳回值

FsRtlInsertPerStreamContext 會傳回下列其中一個 NTSTATUS 值:

傳回碼 描述
STATUS_SUCCESS
FsRtlInsertPerStreamContext 的呼叫成功。
STATUS_INVALID_DEVICE_REQUEST
基礎檔系統不支援篩選內容。

言論

文件系統篩選驅動程式會呼叫 FsRtlInsertPerStreamContext,將它自己的每個數據流內容結構與檔案數據流產生關聯。 每個數據流內容結構包含篩選驅動程式為檔案數據流維護的內容資訊。

在個別數據流內容結構與檔案數據流相關聯之後,可以藉由呼叫 FsRtlLookupPerStreamContext 或呼叫 FsRtlRemovePerStreamContext來擷取。

如需詳細資訊,請參閱舊版文件系統篩選驅動程式中的 追蹤 Per-Stream 內容。

要求

要求 價值
最低支援的用戶端 Windows 2000 SP4 更新匯總;Windows XP
目標平臺 普遍
標頭 ntifs.h (include Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

FSRTL_ADVANCED_FCB_HEADER

FSRTL_PER_STREAM_CONTEXT

FsRtlGetPerStreamContextPointer

FsRtlInitPerStreamContext

FsRtlLookupPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSetupAdvancedHeader

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts