FwpmCalloutDeleteByKey0 関数 (fwpmk.h)

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

構文

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	フィルターエンジンには、キーのパラメーターで指定された GUID と一致する吹き出しはありません。
その他の NTSTATUS コード	エラーが発生しました。

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

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

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

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