Поделиться через

Метод INetworkListManager::GetNetworkConnection (netlistmgr.h)

  • Статья

Метод GetNetworkConnection извлекает сеть на основе предоставленного идентификатора сетевого подключения.

Синтаксис

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

Параметры

[in] gdNetworkConnectionId

Идентификатор GUID, указывающий идентификатор сетевого подключения.

[out, retval] ppNetworkConnection

Указатель на указатель на объект INetworkConnection , связанный с предоставленным gdNetworkConnectionId.

Возвращаемое значение

Возвращает S_OK, если метод выполнен успешно. В противном случае метод возвращает одно из следующих значений.

Код возврата Описание
S_FALSE
 Сеть, связанная с указанным идентификатором сетевого подключения, не найдена.
E_POINTER
 Переданный указатель имеет значение NULL.
E_UNEXPECTED
 Указанный ИДЕНТИФИКАТОР GUID недопустим.

Комментарии

Этот метод может возвращать S_FALSE , если сетевое подключение, связанное с указанным идентификатором, было удалено. Например, клиент может получить событие INetworkConnectionEvents::NetworkConnectionConnectivityChanged вместе с идентификатором сетевого подключения, но обнаруживает, что сетевое подключение было отключено или даже заменено временем вызова INetworkListManager::GetNetworkConnection с указанным идентификатором.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header netlistmgr.h

См. также раздел

INetworkConnection

INetworkListManager