通过

INetworkListManager：：GetNetworkConnection 方法 (netlistmgr.h)

  • 项目

GetNetworkConnection 方法根据提供的网络连接 ID 检索网络。

语法

HRESULT GetNetworkConnection(
  [in]          GUID               gdNetworkConnectionId,
  [out, retval] INetworkConnection **ppNetworkConnection
);

参数

[in] gdNetworkConnectionId

指定网络连接 ID 的 GUID 。

[out, retval] ppNetworkConnection

指向与提供的 gdNetworkConnectionId 关联的 INetworkConnection 对象的指针的指针。

返回值

如果该方法成功，则会返回 S_OK。 否则， 方法将返回以下值之一。

返回代码 说明
S_FALSE
 找不到与指定网络连接 ID 关联的网络。
E_POINTER
 传递的指针为 NULL。
E_UNEXPECTED
 指定的 GUID 无效。

注解

如果已删除与指定 ID 关联的网络连接，此方法可以返回 S_FALSE 。 例如，客户端可能会收到 INetworkConnectionEvents：：NetworkConnectionConnectivityChanged 事件以及网络连接 ID，但发现网络连接已断开连接，甚至被使用提供的 ID 调用 INetworkListManager：：GetNetworkConnection 的时间所替换。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 netlistmgr.h

另请参阅

INetworkConnection

INetworkListManager