INetFwV6Mgr::GetConnection 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 GetConnection method returns the INetFwV6Connection interface identified by a passed in connection ID. The connection ID is the string form of the GUID for the connection, for example, the AdapterName member of the IP_ADAPTER_ADDRESSES structure for that connection.
Syntax
HRESULT GetConnection(
[in] BSTR bstrConnectionId,
[out] INetFwV6Connection **ppConnection
);
Parameters
-
bstrConnectionId [in]
-
String that contains the connection ID.
-
ppConnection [out]
-
Pointer to a connection interface.
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 was unable to allocate required memory. |
|
A pointer passed as a parameter is not valid. |
|
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 |
|
DLL |
|