FwpsCalloutUnregisterByKey0 関数 (fwpsk.h)
FwpsCalloutUnregisterByKey0 関数は、フィルター エンジンから吹き出しの登録を解除します。
メモFwpsCalloutUnregisterByKey0 は、 FwpsCalloutUnregisterByKey の特定のバージョンです。 詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象 とする」を参照してください。
構文
NTSTATUS FwpsCalloutUnregisterByKey0(
[in] const GUID *calloutKey
);
パラメーター
[in] calloutKey
フィルター エンジンから登録解除されている吹き出しを一意に識別する GUID へのポインター。 フィルター エンジンに吹き出しを登録するには、引き出し線ドライバーが FwpsCalloutRegister0 または FwpsCalloutRegister1 関数を呼び出したときに指定されたのと同じ GUID へのポインターである必要があります。
戻り値
FwpsCalloutUnregisterByKey0 関数は、次の NTSTATUS コードのいずれかを返します。
| リターン コード | 説明 |
|---|---|
|
吹き出しがフィルター エンジンから正常に登録解除されました。 |
|
データ フローに関連付けられた未処理のコンテキストを持つ、吹き出しによって処理される 1 つ以上のデータ フローがあります。 コールアウト ドライバーは、関連するコンテキストを削除するために、これらのデータ フローごとに FwpsFlowRemoveContext0 関数を呼び出す必要があります。 これらの各データ フローからコンテキストが正常に削除された後、吹き出しドライバーは、フィルター エンジンからの吹き出しの登録解除を完了するために 、FwpsCalloutUnregisterByKey0 関数をもう一度呼び出す必要があります。 |
|
calloutKey パラメーターで指定された GUID と一致する吹 き出し がフィルター エンジンに登録されていません。 |
|
吹き出しは、既に別のスレッドで登録または登録解除中です。 |
|
エラーが発生しました。 |
解説
吹き出しドライバーは 、FwpsCalloutUnregisterByKey0 関数を呼び出してフィルター エンジンから吹き出しを登録解除します。GUID キーを使用して、登録解除する吹き出しを識別します。 フィルター エンジンにフィルターのアクションの吹き出しを指定するフィルターがある場合でも、この関数は成功します。 このような状況では、FWP_ACTION_CALLOUT_TERMINATINGまたはFWP_ACTION_CALLOUT_UNKNOWNのアクションの種類を持つフィルターはFWP_ACTION_BLOCKとして扱われ、吹き出しがフィルター エンジンから登録解除された後、アクションの種類がFWP_ACTION_CALLOUT_INSPECTIONのフィルターは無視されます。
以前にフィルター エンジンに登録されていたすべての吹き出しが正常に登録解除されるまで、引き出しドライバーをアンロードできません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | fwpsk.h (Fwpsk.h を含む) |
| Library | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |