Функция LookupPrivilegeValueA (winbase.h)
Функция LookupPrivilegeValue извлекает локально уникальный идентификатор (LUID), используемый в указанной системе для локального представления указанного имени привилегий.
Синтаксис
BOOL LookupPrivilegeValueA(
[in, optional] LPCSTR lpSystemName,
[in] LPCSTR lpName,
[out] PLUID lpLuid
);
Параметры
[in, optional] lpSystemName
Указатель на строку, завершающуюся значением NULL, которая указывает имя системы, в которой извлекается имя привилегии. Если задана строка NULL, функция пытается найти имя привилегий в локальной системе.
[in] lpName
Указатель на строку, завершающую значение NULL, которая указывает имя привилегии, как определено в файле заголовка Winnt.h. Например, этот параметр может указать константу, SE_SECURITY_NAME или соответствующую строку SeSecurityPrivilege.
[out] lpLuid
Указатель на переменную, получающую LUID, с помощью которой привилегия известна в системе, указанной параметром lpSystemName.
Возвращаемое значение
Если функция выполнена успешно, функция возвращает ненулевое значение.
Если функция завершается ошибкой, она возвращает ноль. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Функция LookupPrivilegeValue поддерживает только привилегии, указанные в разделе "Определенные привилегии" Winnt.h. Список значений см. в разделе Константы привилегий.
Примеры
Пример использования этой функции см. в разделе Включение и отключение привилегий.
Заметка
Заголовок winbase.h определяет LookupPrivilegeValue как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [классические приложения | Приложения UWP] |
| минимальный поддерживаемый сервер | Windows Server 2003 [классические приложения | Приложения UWP] |
| целевая платформа | Виндоус |
| заголовка | winbase.h (включая Windows.h) |
| библиотеки |
Advapi32.lib |
| DLL | Advapi32.dll |
См. также