Функция NetFileGetInfo (lmshare.h)

Статья
08/24/2023

Извлекает сведения о конкретном открытии ресурса сервера.

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetFileGetInfo(
  [in]  LMSTR  servername,
  [in]  DWORD  fileid,
  [in]  DWORD  level,
  [out] LPBYTE *bufptr
);

Параметры

[in] servername

Указатель на строку, указывающую DNS- или NetBIOS-имя удаленного сервера, на котором выполняется функция. Если этот параметр имеет значение NULL, используется локальный компьютер.

Если определена _WIN32_WINNT или FORCE_UNICODE , эта строка имеет значение Юникод.

[in] fileid

Указывает идентификатор файла открытого ресурса, для которого возвращаются сведения. Значение этого параметра должно быть возвращено в предыдущем вызове перечисления. Дополнительные сведения см. в разделе "Примечания".

[in] level

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

Значение	Значение
2	Возвращает идентификационный номер файла. Параметр bufptr является указателем на структуру FILE_INFO_2 .
3	Возвращает идентификационный номер файла и другие сведения о файле. Параметр bufptr является указателем на структуру FILE_INFO_3 .

[out] bufptr

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

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

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

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

Код возврата	Описание
ERROR_ACCESS_DENIED	У пользователя нет доступа к запрошенной информации.
ERROR_FILE_NOT_FOUND	Файл не найден.
ERROR_INVALID_LEVEL	Значение, указанное для параметра level , является недопустимым.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти.
NERR_BufTooSmall	Предоставленный буфер слишком мал.

При программировании для Active Directory можно вызвать определенные методы интерфейса службы Active Directory (ADSI) для достижения тех же функциональных возможностей, которые можно достичь, вызвав NetFileGetInfo. Дополнительные сведения см. в разделах IADsResource и IADsFileServiceOperations.

Требования


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