Метод INetFwPolicy::GetProfileByType (netfw.h)

Статья
08/25/2023

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

Извлекает профиль запрошенного типа.

Синтаксис

HRESULT GetProfileByType(
  [in]       NET_FW_PROFILE_TYPE profileType,
  [out, ref] INetFwProfile       **profile
);

Параметры

[in] profileType

Тип профиля из NET_FW_PROFILE_TYPE.

[out, ref] profile

Получен профиль типа INetFwProfile.

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

C++

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

VB

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

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

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

Требования

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

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

INetFwPolicy

INetFwProfile

NET_FW_PROFILE_TYPE

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