FwpmCalloutDeleteByKey0 関数 (fwpmk.h)

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

構文

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

パラメーター

[in] engineHandle

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

[in] key

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

戻り値

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

備考

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

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

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

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

必要条件

関連項目

• FwpmCalloutAdd0 を する
• FwpmCalloutDeleteById0 を する
• FwpmEngineOpen0 を する
• Windows フィルタリング プラットフォームの