Функция FwpmSystemPortsUnsubscribe0 (fwpmu.h)

  • Статья

Функция FwpmSystemPortsUnsubscribe0 используется для отмены подписки на системный порт и прекращения получения уведомлений.

Синтаксис

DWORD FwpmSystemPortsUnsubscribe0(
  [in, optional] HANDLE engineHandle,
  [in, out]      HANDLE sysPortsHandle
);

Параметры

[in, optional] engineHandle

Тип: HANDLE

Дескриптор открытого сеанса в обработчике фильтров. Вызовите FwpmEngineOpen0 , чтобы открыть сеанс для подсистемы фильтрации.

[in, out] sysPortsHandle

Тип: HANDLE

Дескриптор уведомления о системных портах, подписанных. Это дескриптор, возвращенный вызовом FwpmSystemPortsSubscribe0.

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

Тип: DWORD

Возвращаемый код или значение Описание
ERROR_SUCCESS
0
 Подписка успешно удалена.
Код ошибки FWP_E_*
0x80320001 — 0x80320039
 Ошибка, определяемая платформой фильтрации Windows (ПППП). Дополнительные сведения см. в разделе Коды ошибок МПП .
Код ошибки RPC_*
0x80010001 — 0x80010122
 Сбой связи с удаленным или локальным обработчиком брандмауэра.

Комментарии

Отмена подписки с недопустимым дескриптором объекта приведет к возврату значения ERROR_SUCCESS, но фактическая подписка будет сохраняться до вызова API отмены подписки с допустимыми параметрами.

Если обратный вызов выполняется в данный момент, эта функция не будет возвращать, пока не завершится. Таким образом, при вызове этой функции не следует удерживать блокировки, которые также может попытаться получить обратный вызов, чтобы не было взаимоблокировки.

Нет необходимости отменять подписку перед закрытием сеанса; все подписки автоматически отменяются при завершении сеанса подписки.

Эту функцию нельзя вызвать из транзакции. Это приведет к сбою при FWP_E_TXN_IN_PROGRESS. Дополнительные сведения о транзакциях см. в разделе Управление объектами.

FwpmSystemPortsUnsubscribe0 — это конкретная реализация FwpmSystemPortsUnsubscribe. Дополнительные сведения см. в разделах Имена Version-Independent и Выбор конкретных версий Windows .

Требования

   
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header fwpmu.h
Библиотека Fwpuclnt.lib
DLL Fwpuclnt.dll

См. также раздел

FwpmSystemPortsSubscribe0