iNetFwOpenPorts::Item 方法 (netfw.h)
[Windows 防火墙 API 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 对于 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 SP2 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 SP1 [仅限桌面应用] |
目标平台 | Windows |
标头 | netfw.h |
DLL | FirewallAPI.dll;使用 SP2 在 Windows XP 上 Hnetcfg.dll |