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

Функция NetAccessEnum (lmaccess.h)

  • Статья

[Эта функция устарела. Список альтернативных функций см. в разделе Функции авторизации.]

Не поддерживается.

Функция NetAccessEnum извлекает сведения о каждой записи разрешения на доступ.

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetAccessEnum(
  LPCWSTR servername,
  LPCWSTR BasePath,
  DWORD   Recursive,
  DWORD   level,
  LPBYTE  *bufptr,
  DWORD   prefmaxlen,
  LPDWORD entriesread,
  LPDWORD totalentries,
  LPDWORD resume_handle
);

Параметры

servername

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

BasePath

Указатель на строку, содержащую базовый путь для ресурса. Указатель NULL или строка NULL означает, что базовый путь не используется. Путь можно указать в виде UNC-имени пути.

Recursive

Указывает флаг, который включает или отключает рекурсивный поиск.

Если этот параметр равен нулю, функция NetAccessEnum возвращает записи для ресурса с именем в качестве базового пути в параметре pszBasePath и для ресурсов непосредственно под этим базовым путем.

Если этот параметр не равен нулю, функция возвращает записи для всех списков управления доступом (ACL), которые имеют pszBasePath в начале имени ресурса.

level

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

Значение Значение
0
 Параметр pbBuffer указывает на структуру access_info_0 .
1
 Параметр pbBuffer указывает на структуру access_info_1 .

bufptr

Указатель на буфер, который получает структуру сведений о доступе. Формат этих данных зависит от значения параметра sLevel .

prefmaxlen

Задает размер (в байтах) буфера, на который указывает параметр pbBuffer .

entriesread

Указатель на короткое целое число без знака, которое получает количество фактически перечисленных элементов. Счетчик действителен, только если функция NetAccessEnum возвращает NERR_Success или ERROR_MORE_DATA.

totalentries

Указатель на короткое целое число без знака, которое получает общее количество записей, которые можно было перечислить. Счетчик действителен, только если функция NetAccessEnum возвращает NERR_Success или ERROR_MORE_DATA.

resume_handle

TBD

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

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

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

Комментарии

Для успешного выполнения этой функции на компьютере с включенной локальной безопасностью требуется Администратор привилегий.

Требования

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

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

Функции авторизации