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

Статья
02/29/2024

Функция 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 (включая Fwpsk.h)
Библиотека	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL