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