FwpmCalloutDeleteById0 関数 (fwpmk.h)

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

構文

NTSTATUS FwpmCalloutDeleteById0(
  [in] HANDLE engineHandle,
  [in] UINT32 id
);

[in] engineHandle

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

[in] id

フィルターエンジンから削除される吹き出しの実行時識別子。これは、吹き出しドライバーが FwpmCalloutAdd0 関数を呼び出してフィルターエンジンに引き出しを追加したときに返されたランタイム識別子である必要があります。

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

リターンコード	形容
STATUS_SUCCESS	吹き出しがフィルターエンジンから正常に削除されました。
STATUS_FWP_IN_USE	フィルターエンジン内の 1 つ以上のフィルターで、フィルターのアクションの吹き出しを指定します。
STATUS_FWP_CALLOUT_NOT_FOUND	id パラメーターで指定されたランタイム識別子と一致する吹き出しがフィルターエンジンにありません。
その他の NTSTATUS コード	エラーが発生しました。

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

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

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

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