Функции WNet

Windows сетевые функции предоставляют сведения и служебные программы для управления сетевыми ресурсами. Функции Windows сети можно сгруппировать следующим образом:

Функции подключения

Вызовите следующие функции подключения WNet для подключения локального устройства к сетевому ресурсу и отмены сетевых подключений.

Функция Описание:
MultinetGetConnectionPerformance Возвращает сведения о ожидаемой производительности подключения к сетевому ресурсу.
WNetAddConnection Подключает локальное устройство к сетевому ресурсу. (Предоставляется для совместимости с 16-разрядными версиями Windows.)
WNetAddConnection2 Подключает локальное устройство к сетевому ресурсу.
WNetAddConnection3 Подключает локальное устройство к сетевому ресурсу. Эта функция включает в себя еще один параметр, чем функция WNetAddConnection2 , дескриптор окна, который поставщик сети может использовать в качестве окна владельца для диалоговых окон.
WNetCancelConnection Отменяет сетевое подключение. (Предоставляется для совместимости с 16-разрядными версиями Windows.)
WNetCancelConnection2 Отменяет сетевое подключение, предоставляя возможность обновлять профиль пользователя с информацией о постоянных подключениях.
WNetConnectionDialog Запускает диалоговое окно общего просмотра для подключения к сетевым ресурсам.
WNetConnectionDialog1 Запускает общее диалоговое окно просмотра для подключения к сетевым ресурсам с помощью структуры CONNECTDLGSTRUCT .
WNetDisconnectDialog Запускает общее диалоговое окно просмотра для отключения от сетевых ресурсов.
WNetDisconnectDialog1 Запускает общее диалоговое окно просмотра для отключения от сетевых ресурсов с помощью структуры DISCDLGSTRUCT .
WNetGetConnection Извлекает имя сетевого ресурса, связанного с локальным устройством.
WNetGetUniversalName При указании пути на основе диска для сетевого ресурса возвращается более универсальная форма имени.
WNetRestoreConnectionW Восстанавливает подключение к сетевому ресурсу, запрашивая у пользователя при необходимости имя и пароль.
WNetUseConnection Подключает локальное устройство к сетевому ресурсу; автоматически выбирает неиспользуемое локальное устройство для перенаправления к сетевому ресурсу.

 

Примечание

Функции WNetAddConnection и WNetCancelConnection поддерживаются для обеспечения совместимости с Windows для рабочих групп. Однако новые приложения должны использовать WNetAddConnection2 или WNetAddConnection3 и WNetCancelConnection2.

 

Функции перечисления

Вызовите следующие функции WNet для перечисления сетевых ресурсов.

Функция Описание:
WNetCloseEnum Завершает перечисление сетевых ресурсов.
WNetEnumResource Продолжает перечисление сетевых ресурсов, запущенных функцией WNetOpenEnum .
WNetOpenEnum Запускает перечисление сетевых ресурсов.

 

Информационные функции

Вызовите следующие информационные и служебные функции WNet, чтобы получить поставщик сети и другие сведения.

Функция Описание:
WNetGetLastError Возвращает последний код ошибки, заданный функцией WNet, сообщаемой поставщиком сети.
WNetGetNetworkInformation Возвращает расширенные сведения о конкретном поставщике сети.
WNetGetProviderName Возвращает имя поставщика для определенного типа сети.
WNetGetResourceInformation Возвращает сетевой поставщик, которому принадлежит ресурс, и получает сведения о типе ресурса.
WNetGetResourceParent Возвращает родительский объект сетевого ресурса.

 

Пользовательские функции

Вызовите следующую функцию WNet, чтобы получить имя пользователя, связанного с локальным устройством.

Функция Описание:
WNetGetUser Возвращает текущее имя пользователя по умолчанию или имя пользователя, которое установило подключение.

 

Многие функции WNet используют структуру NETRESOURCE для хранения сведений о сетевом ресурсе.