FwpsCalloutUnregisterByKey0 関数 (fwpsk.h)
FwpsCalloutUnregisterByKey0 関数は、フィルター エンジンからの吹き出しの登録を解除します。
構文
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 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | fwpsk.h (Fwpsk.h を含む) |
| ライブラリ | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
吹き出し の の種類