Функция FwpmConnectionUnsubscribe0 (fwpmu.h)
Функция FwpmConnectionUnsubscribe0 используется для отмены подписки на событие изменения объекта подключения и прекращения получения уведомлений.
Синтаксис
DWORD FwpmConnectionUnsubscribe0(
[in] HANDLE engineHandle,
[in, out] HANDLE eventsHandle
);
Параметры
[in] engineHandle
Тип: HANDLE
Дескриптор открытого сеанса для подсистемы фильтрации. Вызовите FwpmEngineOpen0 , чтобы открыть сеанс для подсистемы фильтрации.
[in, out] eventsHandle
Тип: HANDLE
Дескриптор уведомления о событии, на которое подписана подписка. Это дескриптор, возвращенный вызовом FwpmConnectionSubscribe0.
Может иметь значение NULL, и в этом случае функция не будет действовать.
Возвращаемое значение
Тип: DWORD
| Возвращаемый код/значение | Описание |
|---|---|
|
Подписка успешно удалена. |
|
Ошибка, определяемая платформой фильтрации Windows (WFP). Дополнительные сведения см. в разделе Коды ошибок ВПП . |
|
Сбой связи с подсистемой удаленного или локального брандмауэра. |
Комментарии
Если обратный вызов выполняется в данный момент, эта функция не будет возвращать, пока не завершится. Таким образом, при вызове этой функции не следует удерживать блокировки, которые также может попытаться получить обратный вызов, чтобы избежать взаимоблокировки.
Нет необходимости отменять подписку перед закрытием сеанса; все подписки автоматически отменяются при завершении сеанса подписки.
Эту функцию нельзя вызвать из транзакции. При FWP_E_TXN_IN_PROGRESS произойдет сбой. Дополнительные сведения о транзакциях см. в разделе Управление объектами.
Требования
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | fwpmu.h |
| Библиотека | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |