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 の特定のバージョンを対象とする」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー fwpmk.h (Fwpmk.h を含む)
ライブラリ Fwpkclnt.lib
IRQL PASSIVE_LEVEL

関連項目