Функции 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 .
WNetOpenUm Запускает перечисление сетевых ресурсов.

 

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

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

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

 

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

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

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

 

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