FwpmCalloutDeleteByKey0 関数 (fwpmk.h)

FwpmCalloutDeleteByKey0 関数は、フィルターエンジンから吹き出しを削除します。

注FwpmCalloutDeleteByKey0 は 、FwpmCalloutDeleteByKey の特定のバージョンです。詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象とする」を参照してください。

構文

NTSTATUS FwpmCalloutDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

[in] engineHandle

フィルターエンジンへの開いているセッションのハンドル。コールアウトドライバーは FwpmEngineOpen0 関数を呼び出して、フィルターエンジンへのセッションを開きます。

[in] key

フィルターエンジンから削除される吹き出しを一意に識別する GUID へのポインター。これは、吹き出しドライバーが FwpmCalloutAdd0 関数を呼び出して吹き出しをフィルターエンジンに追加したときに指定されたのと同じ GUID へのポインターである必要があります。

FwpmCalloutDeleteByKey0 関数は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	吹き出しがフィルターエンジンから正常に削除されました。
STATUS_FWP_IN_USE	フィルターエンジン内の 1 つ以上のフィルターで、フィルターのアクションの吹き出しを指定します。
STATUS_FWP_CALLOUT_NOT_FOUND	フィルターエンジンには、 key パラメーターで指定された GUID と一致する吹き出しはありません。
その他の状態コード	エラーが発生しました。

コールアウトドライバーは FwpmCalloutDeleteByKey0 関数を呼び出してフィルターエンジンから吹き出しを削除し、GUID キーを使用して削除する吹き出しを識別します。

吹き出しドライバーは、通常、フィルターエンジンから吹き出しを削除しません。ほとんどの場合、これはユーザーモードの Windows フィルタープラットフォーム管理アプリケーションによって処理されます。

吹き出しは、フィルターのアクションの吹き出しを指定するフィルターエンジンにフィルターがない場合にのみ、フィルターエンジンから削除できます。