FltGetTransactionContext 函式 (fltkernel.h)

發行項
02/26/2024

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

語法

NTSTATUS FLTAPI FltGetTransactionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PKTRANSACTION Transaction,
  [out] PFLT_CONTEXT  *Context
);

參數

[in] Instance

呼叫端的不透明實例指標。

[in] Transaction

正在擷取內容之交易的不透明交易指標。

[out] Context

接收交易內容位址之呼叫端配置的變數指標。

傳回值

FltGetTransactionContext 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如：

傳回碼	Description
STATUS_NOT_FOUND	找不到相符的內容。這是錯誤碼。

備註

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

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

若要設定交易的內容，請呼叫 FltSetTransactionContext。

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

若要刪除交易內容，請呼叫 FltDeleteTransactionContext 或 FltDeleteContext。