Функция 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]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Advapi32.lib
DLL Advapi32.dll

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

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

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

LookupPrivilegeDisplayName

LookupPrivilegeName