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


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

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

Синтаксис

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
Предоставленный буфер слишком мал.

Комментарии

Только члены локальной группы Администраторы или Операторы сервера могут успешно выполнять функцию NetFileGetInfo .

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

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

Требования

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

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

FILE_INFO_2

FILE_INFO_3

Функции NetFile

NetFileEnum

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

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