共用方式為

INetworkListManager：：GetNetworkConnection 方法 (netlistmgr.h)

  • 發行項

GetNetworkConnection 方法會根據所提供的網路連線標識符來擷取網路。

語法

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

參數

[in] gdNetworkConnectionId

指定網路連線標識碼的 GUID 。

[out, retval] ppNetworkConnection

與提供的 gdNetworkConnectionId 相關聯的 INetworkConnection 物件的指標指標。

傳回值

若方法成功，會傳回 S_OK。 否則，方法會傳回下列其中一個值。

傳回碼 Description
S_FALSE
 找不到與指定之網路連線標識符相關聯的網路。
E_POINTER
 傳遞的指標為 NULL。
E_UNEXPECTED
 指定的 GUID 無效。

備註

如果已移除與指定標識符相關聯的網路連線，這個方法可以傳回 S_FALSE 。 例如，用戶端可以接收 INetworkConnectionEvents：：NetworkConnectionConnectivityChanged 事件以及網路連線標識符，但發現網路連線已中斷連線，或甚至由 INetworkListManager：：GetNetworkConnection 呼叫時使用提供的標識符來呼叫。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 netlistmgr.h

另請參閱

INetworkConnection

INetworkListManager