FwpsFlowRemoveContext0 関数 (fwpsk.h)

  • [アーティクル]

FwpsFlowRemoveContext0 関数は、以前に関連付けられたコンテキストをデータ フローから削除します。

注FwpsFlowRemoveContext0 は、 FwpsFlowRemoveContext の特定のバージョンです。 詳細については、「 WFP 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 コードを返します。

リターン コード 説明
STATUS_SUCCESS
 コンテキストがデータ フローから正常に削除されました。
STATUS_UNSUCCESSFUL
 現在、データ フローに関連付けられているコンテキストはありません。
STATUS_PENDING
 アクティブな吹き出し分類が進行中です。
その他の状態コード
 エラーが発生しました。

解説

FwpsFlowRemoveContext0 関数がSTATUS_SUCCESSを返す場合、FwpsFlowRemoveContext0 はflowDeleteFn 吹き出し関数を同期的に呼び出します。 FwpsFlowRemoveContext0 がSTATUS_PENDINGを返す場合、アクティブなコールアウト分類が進行中であるため、FwpsFlowRemoveContext0 は flowDeleteFn を非同期的に呼び出します。

要件

要件 値
サポートされている最小のクライアント Windows Vista 以降で使用できます。
対象プラットフォーム ユニバーサル
Header fwpsk.h (Fwpsk.h を含む)
Library Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0

classifyFn

flowDeleteFn