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

Статья
08/24/2023

Функция 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