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

Интерфейс INetwork (netlistmgr.h)

  • Статья

Интерфейс INetwork представляет сеть на локальном компьютере. Он также может представлять коллекцию сетевых подключений с аналогичной сетевой сигнатурой.

Наследование

Интерфейс INetwork наследуется от интерфейса IUnknown . INetwork также содержит следующие типы элементов:

Методы

Интерфейс INetwork содержит следующие методы.

 
INetwork::get_IsConnected

Свойство get_IsConnected указывает, имеет ли сеть какое-либо сетевое подключение.
INetwork::get_IsConnectedToInternet

Свойство get_IsConnectedToInternet указывает, подключена ли сеть к Интернету.
INetwork::GetCategory

Метод GetCategory возвращает категорию сети.
INetwork::GetConnectivity

Метод GetConnectivity возвращает состояние подключения сети.
INetwork::GetDescription

Метод GetDescription возвращает строку описания для сети.
INetwork::GetDomainType

Метод GetDomainType возвращает тип домена сети.
INetwork::GetName

Метод GetName возвращает имя сети.
INetwork::GetNetworkConnections

Метод GetNetworkConnections возвращает перечисление всех сетевых подключений для сети. Сеть может иметь несколько подключений к ней из разных интерфейсов или разных связей из одного интерфейса.
INetwork::GetNetworkId

Метод GetNetworkId возвращает уникальный идентификатор сети.
INetwork::GetTimeCreatedAndConnected

Метод GetTimeCreatedAndConnected возвращает локальную дату и время создания и подключения сети.
INetwork::SetCategory

Метод SetCategory задает категорию сети. Внесенные изменения вступают в силу немедленно. Вызывающие объекты этого API должны быть членами группы Администраторы.
INetwork::SetDescription

Метод SetDescription задает или заменяет описание сети.
INetwork::SetName

Метод SetName задает или переименовывает сеть.

Комментарии

Com-объект, реализующий INetwork , также реализует контейнер свойств для дополнительных свойств. Чтобы получить доступ к этому контейнеру свойств, можно использовать интерфейс INetwork и QueryInterface для IPropertyBag. Контейнер свойств этого COM-объекта содержит следующие свойства:

Параметр Тип Описание
NA_DomainAuthenticationFailed VT_BOOL. Указывает, что сеть домена не может пройти проверку подлинности на контроллере домена.
NA_NetworkClass NLM_NETWORK_CLASS значение, сохраненное как VT_UINT Указывает класс сети. Возможные значения:
  • NLM_NETWORK_IDENTIFYING (0x01)

    Это специальная сеть для идентификации. Свойства этого сетевого класса изменить нельзя.

  • NLM_NETWORK_IDENTIFIED (0x02)

    Это идентифицированная сеть.

  • NLM_NETWORK_UNIDENTIFIED (0x03)

    Это специальная "Неопознанная" сеть. Категорию этой сети можно изменить, но она не сохранится при отключении сети.
NA_InternetConnectivityV4

или

NA_InternetConnectivityV6

 NLM_INTERNET_CONNECTIVITY значение, сохраненное как VT_UINT Предоставляет сведения о сетевом подключении IPv4 или IPv6. Возможные значения:
  • NLM_INTERNET_CONNECTIVITY_WEBHIJACK (0x1)

    Обнаруженная сеть является хот-спотом. Например, при подключении к сети Wi-Fi хот-спотов для кофе и перенаправлении локального http-трафика на незащищенный портал будет установлен этот флаг.

  • NLM_INTERNET_CONNECTIVITY_PROXIED (0x2)

    Обнаруженная сеть имеет конфигурацию прокси-сервера. Например, при подключении к корпоративной сети с помощью прокси-сервера для доступа по протоколу HTTP этот флаг будет установлен.

  • NLM_INTERNET_CONNECTIVITY_CORPORATE (0x4)

    Компьютер настроен для прямого доступа, и обнаружен доступ к сети корпоративного домена, для которого настроен прямой доступ.
NA_NameSetByPolicy VT_BOOL. Имя сети задается групповой политикой.
NA_IconSetByPolicy VT_BOOL. Значок сети задан групповой политикой.
NA_DescriptionSetByPolicy VT_BOOL. Описание сети задается групповой политикой.
NA_CategorySetByPolicy VT_BOOL. Категория сети была задана групповой политикой.
NA_NameReadOnly VT_BOOL. Имя сети доступно только для чтения.
NA_IconReadOnly VT_BOOL. Значок сети доступен только для чтения.
NA_DescriptionReadOnly VT_BOOL. Описание сети доступно только для чтения.
NA_CategoryReadOnly VT_BOOL. Категория сети доступна только для чтения.
NA_AllowMerge VT_BOOL. Сеть может быть объединена с другой сетью.
 

Интерфейс IPropertyBag принимает LPCOLESTR как часть методов IPropertyBag::Read и IPropertyBag::Write . Для удобства строковые значения для этих свойств определяются внутри netlistmgr.h с использованием одинаковых имен.

Требования

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