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

Метод INetFwOpenPorts::Add (netfw.h)

  • Статья

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

Открывает новый порт и добавляет его в коллекцию.

Синтаксис

HRESULT Add(
  [in] INetFwOpenPort *port
);

Параметры

[in] port

Порт для добавления в коллекцию.

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

C++

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

VB

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

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

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

Комментарии

Если порт уже открыт, существующие параметры перезаписываются.

Требования

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

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

INetFwOpenPort

INetFwOpenPorts