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 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | fwpsk.h (Fwpsk.h を含む) |
| ライブラリ | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |
関連項目
flowDeleteFn の