INetFwV6Connection::IsGlobalPortIgnored method

[The IPv6 Internet Connection Firewall is available for use in the operating systems specified in the Requirements section. Instead, use the Windows Firewall API.]

The IsGlobalPortIgnored method returns VARIANT_TRUE if the global setting to permit inbound connection attempts is ignored for the specified port and protocol pair.

Syntax

HRESULT IsGlobalPortIgnored(
  [in]  USHORT        usPort,
  [in]  PORT_PROTOCOL Protocol,
  [out] VARIANT_BOOL  *pvbGlobalPortIsIgnored
);

Parameters

usPort [in]

Specifies the port ID in host byte order. Must be in the range 1 65535.

Protocol [in]

Specifies the port protocol type as defined in the PORT_PROTOCOL enumeration.

pvbGlobalPortIsIgnored [out]

Specifies the port name for information only. See the Remarks section for further explanation.

Return value

If the method succeeds the return value is S_OK.

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

Return code	Description
E_ABORT	The operation was aborted.
E_FAIL	An unspecified error occurred.
E_INVALIDARG	One of the parameters is invalid.
E_NOINTERFACE	A specified interface is not supported.
E_NOTIMPL	A specified method is not implemented.
E_OUTOFMEMORY	The method is unable to allocate required memory.
E_POINTER	A pointer passed as a parameter is not valid.
E_UNEXPECTED	The method failed for unknown reasons.

Requirements

Minimum supported client	Windows XP with SP1 [desktop apps only]
Minimum supported server	None supported
End of client support	Windows XP with SP1
Redistributable	Advanced Networking Pack for Windows XP
Header	Netfwv6.h
DLL	Netfwv6.dll

See also

INetFwV6Connection