FltGetInstanceContext 函式（fltkernel.h）

發行項
02/06/2025

FltGetInstanceContext 例程會擷取由指定迷你篩選驅動程式為實例設定的內容。

語法

NTSTATUS FLTAPI FltGetInstanceContext(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_CONTEXT  *Context
);

參數

[in] Instance

實例的不透明實例指標。

[out] Context

接收實例內容位址的呼叫端配置變數指標。這是必要參數，且無法設定為 NULL。

傳回值

FltGetInstanceContext 成功傳回要求的實例內容時，會傳回STATUS_SUCCESS。否則，它會傳回適當的NTSTATUS值，例如：

傳回碼	描述
STATUS_NOT_FOUND	目前在此實例上找不到相符的內容。 FltMgr 會將 Context 設定為 NULL_CONTEXT。這是錯誤碼。

言論

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

FltGetInstanceContext 擷取由指定迷你篩選驅動程式為實例設定的內容。

FltGetInstanceContext 遞增 Context 參數所指向之內容的參考計數。當不再需要此內容指標時，呼叫端必須藉由呼叫 FltReleaseContext來遞減其參考計數。因此，FltGetInstanceContext 的每個成功呼叫，都必須比對 FltReleaseContext的後續呼叫。

若要設定實例的內容，請呼叫 FltSetInstanceContext。

若要設定新的內容，請呼叫 FltAllocateContext。

若要刪除檔案內容，請呼叫 FltDeleteInstanceContext 或 FltDeleteContext。