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


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

Функция NetGetDisplayInformationIndex возвращает индекс первой отображаемой информации, имя которой начинается с указанной строки или имя которой в алфавитном порядке следует за строкой. Эту функцию можно использовать для определения начального индекса для последующих вызовов функции NetQueryDisplayInformation .

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetGetDisplayInformationIndex(
  [in]  LPCWSTR ServerName,
  [in]  DWORD   Level,
  [in]  LPCWSTR Prefix,
  [out] LPDWORD Index
);

Параметры

[in] ServerName

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

[in] Level

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

Значение Значение
1
Запрашивать все локальные и глобальные (обычные) учетные записи пользователей.
2
Запрос всех учетных записей пользователей рабочих станций и серверов.
3
Запрос всех глобальных групп.

[in] Prefix

Указатель на строку, указывающую префикс, по которому выполняется поиск.

[out] Index

Указатель на значение, которое получает индекс запрошенной записи.

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

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

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

Код возврата Описание
ERROR_ACCESS_DENIED
Пользователь не имеет доступа к запрошенной информации.
ERROR_INVALID_LEVEL
Недопустимое значение, указанное для параметра Level .
ERROR_NO_MORE_ITEMS
Больше не было элементов, с которыми можно было бы работать.
NERR_InvalidComputer
Недопустимое имя компьютера.

Комментарии

Если вы вызываете эту функцию на контроллере домена под управлением Active Directory, доступ разрешен или запрещен на основе списка управления доступом (ACL) для защищаемого объекта. Список управления доступом по умолчанию позволяет просматривать сведения всем пользователям, прошедшим проверку подлинности, и членам группы "Доступ, совместимый с Windows 2000". Если вы вызываете эту функцию на рядовом сервере или рабочей станции, все пользователи, прошедшие проверку подлинности, смогут просматривать сведения. Сведения об анонимном доступе и ограничении анонимного доступа на этих платформах см. в разделе Требования к безопасности для функций управления сетью. Дополнительные сведения о списках управления доступом, ACE и маркерах доступа см. в разделе модель контроль доступа.

Функция возвращает только сведения, к которым вызывающий объект имеет доступ на чтение. Вызывающий объект должен иметь доступ к объекту Domain (Список содержимого) и Полный доступ к домену SAM в объекте SAM Server, расположенном в контейнере System.

Требования

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

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

Получение функций

NetQueryDisplayInformation

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

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