FltDeleteTransactionContext 函式 (fltkernel.h)

發行項
02/26/2024

FltDeleteTransactionContext 例程會從指定的交易中移除內容，並標記要刪除的內容。

語法

NTSTATUS FLTAPI FltDeleteTransactionContext(
  [in]            PFLT_INSTANCE Instance,
  [in]            PKTRANSACTION Transaction,
  [out, optional] PFLT_CONTEXT  *OldContext
);

參數

[in] Instance

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

[in] Transaction

刪除內容之交易的不透明交易指標。

[out, optional] OldContext

接收已刪除內容位址之呼叫端配置的變數指標。此參數是選擇性的，可以是 NULL。如果 OldContext 不是 NULL 且未指向 NULL_CONTEXT，則呼叫端會負責呼叫 FltReleaseContext ，以在不再需要時釋出此內容。

傳回值

FltDeleteTransactionContext 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，如下所示：

傳回碼	Description
STATUS_FLT_DELETING_OBJECT	指定的實例正在損毀。這是錯誤碼。
STATUS_NOT_FOUND	找不到相符的內容。這是錯誤碼。

備註

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

因為內容是參考計數，所以小型篩選驅動程式通常不需要呼叫 FltDeleteTransactionContext 之類的例程，才能明確刪除內容。

迷你篩選驅動程式會呼叫 FltDeleteTransactionContext ，從交易中移除內容，並標記要刪除的內容。內容通常會立即釋出，除非有未處理的參考 (，因為內容仍由另一個線程) 使用。

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

若要擷取交易內容，請呼叫 FltGetTransactionContext。

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

規格需求

需求	值
最低支援的用戶端	Windows Vista 和更新版本
目標平台	Universal
標頭	fltkernel.h (包含 Fltkernel.h)
程式庫	FltMgr.lib
IRQL	<= APC_LEVEL