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


Функция LsaEnumerateAccountRights (ntsecapi.h)

Функция LsaEnumerateAccountRights перечисляет привилегии, назначенные учетной записи.

Синтаксис

NTSTATUS LsaEnumerateAccountRights(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PSID                AccountSid,
  [out] PLSA_UNICODE_STRING *UserRights,
  [out] PULONG              CountOfRights
);

Параметры

[in] PolicyHandle

Дескриптор объекта Policy . Дескриптор должен иметь право доступа POLICY_LOOKUP_NAMES. Дополнительные сведения см. в разделе Открытие дескриптора объекта политики.

[in] AccountSid

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

[out] UserRights

Получает указатель на массив LSA_UNICODE_STRING структур. Каждая структура содержит имя привилегии, удерживаемой учетной записью. Список имен привилегий см. в разделе Константы привилегий.

Если сведения больше не нужны, передайте возвращенный указатель в LsaFreeMemory.

[out] CountOfRights

Указатель на переменную, которая получает количество привилегий в массиве UserRights .

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

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

Если права учетной записи не найдены или функция завершается сбоем по какой-либо другой причине, функция возвращает код NTSTATUS, например FILE_NOT_FOUND. Дополнительные сведения см. в разделе Возвращаемые значения функции политики LSA. Используйте функцию LsaNtStatusToWinError для преобразования кода NTSTATUS в код ошибки Windows.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntsecapi.h
Библиотека Advapi32.lib
DLL Advapi32.dll

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

LSA_UNICODE_STRING

LsaAddAccountRights

LsaFreeMemory

LsaRemoveAccountRights