Compartir a través de

INetFwV6Connection::ObserveGlobalPort method

  • Artículo

[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 ObserveGlobalPort method modifies the firewall configuration for a connection to respect the global setting that permit connection attempts for the specified port and protocol.

Syntax

HRESULT ObserveGlobalPort(
  [in] USHORT        usPort,
  [in] PORT_PROTOCOL Protocol
);

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.

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_UNEXPECTED
 The method failed for unknown reasons.

Remarks

It is not an error to call ObserveGlobalPort for a port and protocol pair that is not ignored, (for example, a pair for which IsGlobalPortIgnored returns VARIANT_FALSE), even though such a call has no actual effect on the system.

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