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


Функция NetUseGetInfo (lmuse.h)

Функция NetUseGetInfo извлекает сведения о подключении к общему ресурсу.

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

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetUseGetInfo(
  [in]  LMSTR  UncServerName,
  [in]  LMSTR  UseName,
  [in]  DWORD  LevelFlags,
  [out] LPBYTE *bufptr
);

Параметры

[in] UncServerName

UNC-имя компьютера, на котором выполняется эта функция. Если этот параметр имеет значение NULL, используется локальный компьютер. Если указанный параметр UncServerName является удаленным компьютером, удаленный компьютер должен поддерживать удаленные вызовы RPC с использованием устаревшего механизма протокола удаленного доступа.

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

[in] UseName

Указатель на строку, указывающую имя соединения, для которого возвращаются сведения.

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

[in] LevelFlags

Уровень информации запрашиваемых данных. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
0
Указывает имя локального устройства и имя общей папки удаленного ресурса. Параметр BufPtr является указателем на структуру USE_INFO_0 .
1
Указывает сведения о подключении между локальным устройством и общим ресурсом, включая состояние и тип подключения. Параметр BufPtr является указателем на структуру USE_INFO_1 .
2
Указывает сведения о подключении между локальным устройством и общим ресурсом. Сведения включают состояние подключения, тип подключения, имя пользователя и доменное имя. Параметр BufPtr является указателем на структуру USE_INFO_2 .

[out] bufptr

Указатель на буфер, который получает данные. Формат этих данных зависит от значения параметра Level . Этот буфер выделяется системой и должен быть освобожден с помощью функции NetApiBufferFree . Дополнительные сведения см. в разделах Буферы функций управления сетью и Длина буфера функции управления сетью.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NERR_Success.

Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки. Список кодов ошибок см. в разделе Системные коды ошибок.

Комментарии

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

Чтобы получить список всех текущих подключений между локальным компьютером и ресурсами на удаленных серверах, можно вызвать функцию NetUseEnum .

Эта функция применяется только к клиенту server Message Block (LAN Manager Workstation). Функция NetUseGetInfo не поддерживает общие папки распределенной файловой системы (DFS). Чтобы получить сведения о общей папке с помощью другого поставщика сети (например, WebDAV или общего ресурса DFS), используйте функцию WNetGetConnection .

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header lmuse.h (включая Lm.h)
Библиотека Netapi32.lib
DLL Netapi32.dll

См. также раздел

NetUseEnum

Функции управления сетью

Общие сведения об управлении сетью

USE_INFO_0

USE_INFO_1

USE_INFO_2

Использование функций

WNetGetConnection