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

Статья
02/26/2024

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

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

Синтаксис

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

Параметры

[in] engineHandle

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

[in] id

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

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

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

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

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

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

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

Требования

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

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

FwpmCalloutAdd0

FwpmCalloutDeleteByKey0

FwpmEngineOpen0