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

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

  • Статья

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

Синтаксис

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, указанному в параметре ключа .
другие коды NTSTATUS Произошла ошибка.

Замечания

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

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

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

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

Требования

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

См. также