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 を返します。 それ以外の場合、メソッドは次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
指定したネットワーク接続 ID に関連付けられているネットワークが見つかりませんでした。 |
|
渡されるポインターは NULL です。 |
|
指定された GUID が無効です。 |
注釈
指定した ID に関連付けられているネットワーク接続が削除された場合、このメソッドは S_FALSE を返すことができます。 たとえば、クライアントは INetworkConnectionEvents::NetworkConnectionConnectivityChanged イベントをネットワーク接続 ID と共に受信できますが、ネットワーク接続が切断されているか、指定された ID で INetworkListManager::GetNetworkConnection が呼び出された時刻に置き換えられていることがわかります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | netlistmgr.h |