FltGetStreamHandleContext 函式 (fltkernel.h)

發行項
02/26/2024

FltGetStreamHandleContext 例程會擷取指定迷你篩選驅動程序實例針對數據流句柄所設定的內容。

語法

NTSTATUS FLTAPI FltGetStreamHandleContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

參數

[in] Instance

要擷取其內容之迷你篩選驅動程序實例的不透明實例指標。

[in] FileObject

數據流句柄之檔案物件的指標。

[out] Context

接收內容位址的呼叫端配置變數指標。此參數無法設定為 NULL。

傳回值

FltGetStreamHandleContext 會在成功傳回要求的內容時傳回STATUS_SUCCESS。否則，它會傳回適當的NTSTATUS值，例如下列其中一項：

傳回碼	Description
STATUS_NOT_FOUND	目前在此檔案上找不到相符的內容，因此 FltMgr 將 Context 設定為 NULL_CONTEXT。這是錯誤碼。
STATUS_NOT_SUPPORTED	檔案系統不支援此檔案數據流的每個數據流內容。這是錯誤碼。

備註

如需內容的詳細資訊，請參閱關於迷你篩選內容。

FltGetStreamHandleContext 會 擷取由指定迷你篩選驅動程式為數據流句柄設定的內容。

FltGetStreamHandleContext 會在 Context 參數指向的內容上遞增參考計數。當不再需要此內容指標時，呼叫端必須藉由呼叫 FltReleaseContext 來遞減其參考計數。因此，每次成功呼叫 FltGetStreamHandleContext 都必須與 後續對 FltReleaseContext 的呼叫進行比對。

若要設定數據流句柄的內容，請呼叫 FltSetStreamHandleContext

若要配置新的內容，請呼叫 FltAllocateContext。

若要刪除數據流句柄內容，請呼叫 FltDeleteStreamHandleContext 或 FltDeleteContext。