Compartir a través de

INetFwV6Mgr::OpenGlobalPort 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 OpenGlobalPort method modifies the global firewall configuration. This allows inbound connection attempts for the specified port and protocol on all connections, with the exception of those connections that have been configured to ignore the port and protocol.

Syntax

HRESULT OpenGlobalPort(
  [in] USHORT        usPort,
  [in] PORT_PROTOCOL Protocol,
  [in] BSTR          bstrName
);

Parameters

usPort [in]

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

Protocol [in]

Defines protocol type.

bstrName [in]

Display name for the port. For information purposes only.

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
 The parameter 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 OpenGlobalPort for a port and protocol pair that is already open, (for example, a pair for which IsPortGloballyOpen returns VARIANT_TRUE), even though such a call has no actual effect on the system.

The bstrName parameter is for information purposes only, and has no bearing on the operation of the system. Different connections are not required to have the same name for identical port and protocol pairs. Calling OpenGlobalPort for a port and protocol pair that is already open using a different name does not alter the persisted name.

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

INetFwV6Mgr