Функция LookupPrivilegeNameA (winbase.h)

Статья
11/20/2024

Функция LookupPrivilegeName извлекает имя, соответствующее привилегии, представленной в определенной системе указанным локально уникальным идентификатором (LUID).

Синтаксис

BOOL LookupPrivilegeNameA(
  [in, optional]  LPCSTR  lpSystemName,
  [in]            PLUID   lpLuid,
  [out, optional] LPSTR   lpName,
  [in, out]       LPDWORD cchName
);

Параметры

[in, optional] lpSystemName

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

[in] lpLuid

Указатель на LUID, с помощью которого привилегия известна в целевой системе.

[out, optional] lpName

Указатель на буфер, получающий строку, завершающую значение NULL, представляющую имя привилегий. Например, эта строка может быть "SeSecurityPrivilege".

[in, out] cchName

Указатель на переменную, указывающую размер значения TCHARlpName. Когда функция возвращается, этот параметр содержит длину имени привилегии, а не включающее завершающийся символ NULL. Если буфер, на который указывает параметр lpName, слишком мал, эта переменная содержит требуемый размер.

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

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

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

Замечания

Функция LookupPrivilegeName поддерживает только привилегии, указанные в разделе "Определенные привилегии" Winnt.h. Список значений см. в разделе Константы привилегий.

Заметка

Заголовок winbase.h определяет LookupPrivilegeName как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2003 [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Advapi32.lib
DLL	Advapi32.dll

См. также

управления доступом

базовые функции управления доступом

LookupPrivilegeDisplayName

LookupPrivilegeValue

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