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

  • Статья

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

Синтаксис

DWORD FwpmSystemPortsSubscribe0(
  [in, optional] HANDLE                      engineHandle,
                 void                        *reserved,
  [in]           FWPM_SYSTEM_PORTS_CALLBACK0 callback,
  [in, optional] void                        *context,
  [out]          HANDLE                      *sysPortsHandle
);

Параметры

[in, optional] engineHandle

Тип: HANDLE

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

reserved

Тип: void*

Зарезервировано.

[in] callback

Тип: FWPM_SYSTEM_PORTS_CALLBACK0

Указатель на функцию, который будет вызываться, когда уведомление будет готово к доставке.

[in, optional] context

Тип: void*

Необязательный указатель контекста. Этот указатель передается в функцию обратного вызова вместе со сведениями о системных портах.

[out] sysPortsHandle

Тип: HANDLE*

Дескриптор для только что созданной подписки.

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

Тип: DWORD

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

Комментарии

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

FwpmSystemPortsSubscribe0 — это конкретная реализация FwpmSystemPortsSubscribe. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows .

Требования

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

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

FWPM_SYSTEM_PORTS_CALLBACK0

FwpmSystemPortsUnsubscribe0