FwpsFlowRemoveContext0 函式 (fwpsk.h)

  • 發行項

FwpsFlowRemoveContext0 函式會從數據流中移除先前相關聯的內容。

注意FwpsFlowRemoveContext0 是特定版本的 FwpsFlowRemoveContext。 如需詳細資訊 ，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標 。
 

語法

NTSTATUS FwpsFlowRemoveContext0(
  [in] UINT64 flowId,
  [in] UINT16 layerId,
  [in] UINT32 calloutId
);

參數

[in] flowId

運行時間標識碼，指定要從中移除內容的數據流。 數據流的運行時間標識碼會透過傳遞至圖說驅動程式 的classifyFn 圖說文字函式所傳遞的FWPS_METADATA_FIELD_FLOW_HANDLE元數據值提供給圖說文字驅動程式。

[in] layerId

要從中移除內容之篩選層的運行時間標識碼。 如需詳細資訊，請參閱 運行時間篩選圖層標識符。 圖說文字驅動程式應該指定它呼叫 FwpsFlowAssociateContext0 函式時所指定的相同識別符，以將內容與數據流產生關聯。

[in] calloutId

篩選引擎中圖說文字的運行時間標識碼。 呼叫 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函式以向篩選引擎註冊圖說文字時，會傳回此標識碼。

傳回值

FwpsFlowRemoveContext0 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼 Description
STATUS_SUCCESS
 內容已成功從數據流中移除。
STATUS_UNSUCCESSFUL
 目前沒有與數據流相關聯的內容。
STATUS_PENDING
 作用中的圖說文字分類正在進行中。
其他狀態代碼
 發生錯誤。

備註

如果 FwpsFlowRemoveContext0 函式傳回 STATUS_SUCCESS，FwpsFlowRemoveContext0 會同步呼叫 flowDeleteFn 圖說文字函式。 如果 FwpsFlowRemoveContext0 傳回 STATUS_PENDING，FwpsFlowRemoveContext0 會以異步方式呼叫 flowDeleteFn ，因為作用中的圖說文字分類正在進行中。

規格需求

需求 值
最低支援的用戶端 從 Windows Vista 開始提供。
目標平台 Universal
標頭 fwpsk.h (包含 Fwpsk.h)
程式庫 Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

另請參閱

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0

classifyFn

flowDeleteFn