Функция FwpsCalloutUnregisterByKey0 (fwpsk.h)

Функция FwpsCalloutUnregisterByKey0 отменяет регистрацию выноски из обработчика фильтров.

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

Синтаксис

NTSTATUS FwpsCalloutUnregisterByKey0(
  [in] const GUID *calloutKey
);

Параметры

[in] calloutKey

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

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

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

Возвращаемый код Описание
STATUS_SUCCESS
 Выноска была успешно отменена из обработчика фильтров.
STATUS_DEVICE_BUSY
 Существует один или несколько потоков данных, обрабатываемых выноской с выдающимся контекстом, связанным с потоком данных. Драйвер выноски должен вызвать функцию FwpsFlowRemoveContext0 для каждого из этих потоков данных, чтобы удалить связанный контекст. После успешного удаления контекста из каждого из этих потоков данных драйвер выноски должен вызвать функцию FwpsCalloutUnregisterByKey0, чтобы завершить отмену регистрации выноски из обработчика фильтров.
STATUS_FWP_CALLOUT_NOT_FOUND
 Выноска не зарегистрирована в обработчике фильтров, который соответствует GUID, указанному в параметре calloutKey.
STATUS_FWP_IN_USE
 Выноска уже находится в процессе регистрации или отмены регистрации в другом потоке.
Другие коды состояния
 Произошла ошибка.

Замечания

Драйвер выноски вызывает функцию FwpsCalloutUnregisterByKey0 для отмены регистрации выноски из обработчика фильтров с помощью ключа GUID для определения отмены регистрации выноски. Эта функция завершается успешно, даже если в обработчике фильтров есть фильтры, указывающие выноску для действия фильтра. В этой ситуации фильтры с типом действия FWP_ACTION_CALLOUT_TERMINATING или FWP_ACTION_CALLOUT_UNKNOWN обрабатываются как FWP_ACTION_BLOCK, а фильтры с типом действия FWP_ACTION_CALLOUT_INSPECTION игнорируются после отмены регистрации выноски из обработчика фильтров.

Драйвер выноски не может быть выгружен до тех пор, пока все выноски, зарегистрированные ранее в обработчике фильтров, были успешно отменены.

Требования

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

См. также

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterById0

FwpsFlowRemoveContext0

типы выносок

  • Last updated on