通过

INetFwPolicy：：GetProfileByType 方法 (netfw.h)

  • 项目

[Windows 防火墙 API 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 对于 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 类型的配置文件。

检索到 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 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 SP1 [仅限桌面应用]
目标平台 Windows
标头 netfw.h
DLL FirewallAPI.dll;使用 SP2 在 Windows XP 上 Hnetcfg.dll

另请参阅

INetFwPolicy

INetFwProfile

NET_FW_PROFILE_TYPE