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


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

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

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

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

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

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

Комментарии

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

Примечание

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

Требования

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

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

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

Базовые функции контроль доступа

LookupPrivilegeDisplayName

LookupPrivilegeValue