Интерфейс 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