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

Статья
03/08/2023

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

Метод Item возвращает указанное приложение, если оно находится в коллекции.

Синтаксис

HRESULT Item(
  [in]  BSTR                        imageFileName,
  [out] INetFwAuthorizedApplication **app
);

Параметры

[in] imageFileName

Извлекаемое приложение.

[out] app

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

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

C++

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

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

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

VB

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

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

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

Требования

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

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

INetFwAuthorizedApplication

INetFwAuthorizedApplications

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