Функция 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
Уровень информации запрашиваемых данных. Этот параметр может принимать одно из указанных ниже значений.
Значение | Значение |
---|---|
|
Указывает имя локального устройства и имя общей папки удаленного ресурса. Параметр BufPtr является указателем на структуру USE_INFO_0 . |
|
Указывает сведения о подключении между локальным устройством и общим ресурсом, включая состояние и тип подключения. Параметр BufPtr является указателем на структуру USE_INFO_1 . |
|
Указывает сведения о подключении между локальным устройством и общим ресурсом. Сведения включают состояние подключения, тип подключения, имя пользователя и доменное имя. Параметр 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 |