FwpsFlowRemoveContext0 関数 (fwpsk.h)
FwpsFlowRemoveContext0 関数は、以前に関連付けられたコンテキストをデータ フローから削除します。
構文
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 コードを返します。
| リターン コード | 説明 |
|---|---|
|
コンテキストがデータ フローから正常に削除されました。 |
|
現在、データ フローに関連付けられているコンテキストはありません。 |
|
アクティブな吹き出し分類が進行中です。 |
|
エラーが発生しました。 |
解説
FwpsFlowRemoveContext0 関数がSTATUS_SUCCESSを返す場合、FwpsFlowRemoveContext0 はflowDeleteFn 吹き出し関数を同期的に呼び出します。 FwpsFlowRemoveContext0 がSTATUS_PENDINGを返す場合、アクティブなコールアウト分類が進行中であるため、FwpsFlowRemoveContext0 は flowDeleteFn を非同期的に呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | fwpsk.h (Fwpsk.h を含む) |
| Library | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |