Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The GetNetworkConnection method retrieves a network based on a supplied Network Connection ID.
Syntax
HRESULT GetNetworkConnection(
[in] GUID gdNetworkConnectionId,
[out, retval] INetworkConnection **ppNetworkConnection
);
Parameters
[in] gdNetworkConnectionId
A GUID that specifies the Network Connection ID.
[out, retval] ppNetworkConnection
Pointer to a pointer to the INetworkConnection object associated with the supplied gdNetworkConnectionId.
Return value
Returns S_OK if the method succeeds. Otherwise, the method returns one of the following values.
| Return code | Description |
|---|---|
|
The network associated with the specified network connection ID was not found. |
|
The pointer passed is NULL. |
|
The specified GUID is invalid. |
Remarks
This method can return S_FALSE if a network connection associated with the specified ID has been removed. For example, it is possible for a client to receive a INetworkConnectionEvents::NetworkConnectionConnectivityChanged event along with a network connection ID, but find that the network connection has been disconnected or even replaced by the time INetworkListManager::GetNetworkConnection is called with the provided ID.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | netlistmgr.h |