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

Статья
03/05/2024

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

Возвращает указанный порт, если он находится в коллекции.

Синтаксис

HRESULT Item(
  [in]  LONG               portNumber,
  [in]  NET_FW_IP_PROTOCOL ipProtocol,
  [out] INetFwOpenPort     **openPort
);

Параметры

[in] portNumber

Номер порта для поиска.

[in] ipProtocol

Протокол порта для поиска по типу NET_FW_IP_PROTOCOL.

[out] openPort

Ссылка на возвращенный объект INetFwOpenPort .

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

C++

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

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

Ошибка	Описание
E_ACCESSDENIED	Операция была прервана из-за проблем с разрешениями.
E_INVALIDARG	Сбой метода из-за недопустимого параметра.
E_OUTOFMEMORY	Методу не удалось выделить необходимую память.
E_POINTER	Сбой метода из-за недопустимого указателя.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Запрошенный элемент не существует.

VB

Ссылка на возвращенный объект INetFwOpenPort .

Требования

Требование	Значение
Минимальная версия клиента	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

NET_FW_IP_PROTOCOL

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