INetFwOpenPorts::Item method

[The Windows Firewall API is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. For Windows Vista and later, use of the Windows Firewall with Advanced Security API is recommended.]

Returns the specified port if it is in the collection.

Syntax

HRESULT Item(
  LONG               portNumber,
  NET_FW_IP_PROTOCOL ipProtocol,
  INetFwOpenPort     **openPort
);

Parameters

portNumber

Port number to find.

ipProtocol

Protocol of the port to find by type NET_FW_IP_PROTOCOL.

openPort

Reference to the returned INetFwOpenPort object.

Return Value

C++

If the method succeeds, the return value is S_OK.

If the method fails, the return value is one of the following error codes.

Error Description
E_ACCESSDENIED The operation was aborted due to permissions issues.
E_INVALIDARG The method failed due to an invalid parameter.
E_OUTOFMEMORY The method was unable to allocate required memory.
E_POINTER The method failed due to an invalid pointer.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) The requested item does not exist.
 

VB

Reference to the returned INetFwOpenPort object.

Requirements

   
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 with SP1 [desktop apps only]
Target Platform Windows
Header netfw.h
DLL FirewallAPI.dll; Hnetcfg.dll on Windows XP with SP2

See Also

INetFwOpenPort

INetFwOpenPorts

NET_FW_IP_PROTOCOL