Функция FwpmCalloutDeleteByKey0 (fwpmk.h)

Статья
02/26/2024

Функция FwpmCalloutDeleteByKey0 удаляет выноску из подсистемы фильтров.

ПримечаниеFwpmCalloutDeleteByKey0 — это определенная версия FwpmCalloutDeleteByKey. Дополнительные сведения см. в разделах Имена Version-Independent и Выбор конкретных версий Windows .

Синтаксис

NTSTATUS FwpmCalloutDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

Параметры

[in] engineHandle

Дескриптор открытого сеанса для подсистемы фильтрации. Драйвер выноски вызывает функцию FwpmEngineOpen0 , чтобы открыть сеанс для подсистемы фильтрации.

[in] key

Указатель на GUID, который однозначно идентифицирует выноску, удаляемую из подсистемы фильтров. Это должен быть указатель на тот же GUID, который был указан при вызове драйвером выноски функции FwpmCalloutAdd0 , чтобы добавить выноску в подсистему фильтрации.

Возвращаемое значение

Функция FwpmCalloutDeleteByKey0 возвращает один из следующих кодов NTSTATUS.

Код возврата	Описание
STATUS_SUCCESS	Выноска успешно удалена из подсистемы фильтров.
STATUS_FWP_IN_USE	Один или несколько фильтров в подсистеме фильтров указывают выноску для действия фильтра.
STATUS_FWP_CALLOUT_NOT_FOUND	В подсистеме фильтров отсутствует выноска, соответствующая ИДЕНТИФИКАТОРу GUID, указанному в параметре ключа .
Другие коды состояния	Произошла ошибка.

Драйвер выноски вызывает функцию FwpmCalloutDeleteByKey0 , чтобы удалить выноску из подсистемы фильтрации, используя ключ GUID для идентификации выноски, которую необходимо удалить.

Драйверы выносок обычно не удаляют выноски из подсистемы фильтрации. В большинстве случаев это обрабатывается приложением управления платформой фильтрации Windows в пользовательском режиме.

Выноска может быть удалена из подсистемы фильтров только в том случае, если в подсистеме фильтров нет фильтров, определяющих выноску для действия фильтра.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows Vista.
Целевая платформа	Универсальное
Верхняя часть	fwpmk.h (включая Fwpmk.h)
Библиотека	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

См. также раздел

FwpmCalloutAdd0

FwpmCalloutDeleteById0

FwpmEngineOpen0