INetFwServices：：Item 方法 (netfw.h)

[Windows 防火墙 API 可用于“要求”部分中指定的操作系统。它可能在后续版本中变更或不可用。对于 Windows Vista 及更高版本，建议使用具有高级安全 API 的 Windows 防火墙。]

如果指定的服务位于集合中，则返回该服务。

语法

HRESULT Item(
  [in]  NET_FW_SERVICE_TYPE svcType,
  [out] INetFwService       **service
);

[in] svcType

C++	要提取的服务的类型。
VB	要提取的服务的类型。请参阅 NET_FW_SERVICE_TYPE

[out] service

C++	对返回的 INetFwService 对象的引用。
VB	对返回的 INetFwService 对象的引用。

返回代码	说明
E_ACCESSDENIED	由于权限问题，操作已中止。
E_OUTOFMEMORY	方法无法分配所需的内存。
E_POINTER	由于指针无效，方法失败。
E_INVALIDARG	由于参数无效，方法失败。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	方法失败，因为请求的项不存在。

如果该方法成功，则返回值S_OK。

如果方法失败，则返回值为以下错误代码之一。

返回代码	说明
E_ACCESSDENIED	由于权限问题，操作已中止。
E_OUTOFMEMORY	方法无法分配所需的内存。
E_POINTER	由于指针无效，方法失败。
E_INVALIDARG	由于参数无效，方法失败。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	方法失败，因为请求的项不存在。

要求	值
最低受支持的客户端	Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 SP1 [仅限桌面应用]
目标平台	Windows
标头	netfw.h
DLL	FirewallAPI.dll;使用 SP2 在 Windows XP 上 Hnetcfg.dll