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