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

Функции 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 for Workgroups. Однако новые приложения должны использовать WNetAddConnection2 или WNetAddConnection3и WNetCancelConnection2.

 

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

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

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

 

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

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

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

 

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

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

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

 

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