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

Статья
08/25/2023

Функция 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

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