INetFwV6Connection::ObserveGlobalPort 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 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 |
|---|---|
|
The operation was aborted. |
|
An unspecified error occurred. |
|
One of the parameters is invalid. |
|
A specified interface is not supported. |
|
A specified method is not implemented. |
|
The method is unable to allocate required memory. |
|
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 |
|
| DLL |
|