Поделиться через

Функция 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 Один или несколько фильтров в обработчике фильтров указывают выноску для действия фильтра.
STATUS_FWP_CALLOUT_NOT_FOUND В обработчике фильтров нет выноски, которая соответствует идентификатору времени выполнения, указанному в параметре идентификатора .
другие коды NTSTATUS Произошла ошибка.

Замечания

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

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

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

FwpmCalloutDeleteById0 — это конкретная версия FwpmCalloutDeleteById. Дополнительные сведения см. в статье МПП Version-Independent имен и целевых версий Windows.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно начиная с Windows Vista.
целевая платформа Всеобщий
заголовка fwpmk.h (include Fwpmk.h)
библиотеки Fwpkclnt.lib
IRQL PASSIVE_LEVEL

См. также