Поделиться через

Метод INetFwMgr::IsIcmpTypeAllowed (netfw.h)

  • Статья

[API брандмауэра Windows доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Для Windows Vista и более поздних версий рекомендуется использовать API брандмауэра Windows в режиме повышенной безопасности .]

Определяет, разрешен ли указанный тип ICMP.

Синтаксис

HRESULT IsIcmpTypeAllowed(
  [in]  NET_FW_IP_VERSION ipVersion,
  [in]  BSTR              localAddress,
  [in]  BYTE              type,
  [out] VARIANT           *allowed,
  [out] VARIANT           *restricted
);

Параметры

[in] ipVersion

IP-версия трафика. Это не может быть NET_FW_IP_VERSION_ANY.

IP-версия трафика. Это не может быть NET_FW_IP_VERSION_ANY.

[in] localAddress

IPv4-адрес с точками или шестнадцатеричный IPv6-адрес, указывающий локальный адрес трафика. Как правило, это адрес, передаваемый для привязки. Если localAddress имеет значение NULL, функция определяет, разрешен ли порт для всех интерфейсов.

[in] type

Тип ICMP. Список возможных типов ICMP см. в разделе Номера типов ICMP.

[out] allowed

Указывает значением VARIANT_TRUE или VARIANT_FALSE, разрешен ли порт по крайней мере для некоторых локальных интерфейсов и удаленных адресов.

[out] restricted

Указывает значением VARIANT_TRUE или VARIANT_FALSE, заблокированы ли некоторые локальные интерфейсы или удаленные адреса для этого порта. Например, если порт ограничен только локальной подсетью.

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

C++

Код возврата Описание
E_ACCESSDENIED
 Операция была остановлена из-за проблем с разрешениями.
E_INVALIDARG
 Сбой метода, так как параметр был недопустимым.
E_OUTOFMEMORY
 Методу не удалось выделить необходимую память.
E_POINTER
 Сбой метода, так как указатель был недопустимым.
 

VB

Если метод завершается успешно, возвращается значение S_OK.

Если метод завершается ошибкой, возвращается один из следующих кодов ошибок.

Код возврата Описание
E_ACCESSDENIED
 Операция была остановлена из-за проблем с разрешениями.
E_INVALIDARG
 Сбой метода, так как параметр был недопустимым.
E_OUTOFMEMORY
 Методу не удалось выделить необходимую память.
E_POINTER
 Сбой метода, так как указатель был недопустимым.

Комментарии

Вместо этого метода обычно рекомендуется использовать метод INetFwPolicy2::IsRuleGroupEnabled .

Требования

Требование Значение
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа Windows
Header netfw.h
DLL FirewallAPI.dll; Hnetcfg.dll в Windows XP с пакетом обновления 2 (SP2)

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

INetFwMgr

NET_FW_IP_VERSION