lookupPrivilegeValueA 函数 (winbase.h)

LookupPrivilegeValue 函数检索本地唯一标识符 (LUID) 指定系统上用于本地表示指定特权名称。

语法

BOOL LookupPrivilegeValueA(
  [in, optional] LPCSTR lpSystemName,
  [in]           LPCSTR lpName,
  [out]          PLUID  lpLuid
);

参数

[in, optional] lpSystemName

指向以 null 结尾的字符串的指针,该字符串指定检索特权名称的系统的名称。 如果指定了空字符串,则该函数将尝试在本地系统上查找特权名称。

[in] lpName

指向以 null 结尾的字符串的指针,该字符串指定权限的名称,如 Winnt.h 头文件中定义的那样。 例如,此参数可以指定常量、SE_SECURITY_NAME或其对应的字符串“SeSecurityPrivilege”。

[out] lpLuid

指向一个变量的指针,该变量接收 LUID,lpSystemName 参数指定的系统上的权限是已知的。

返回值

如果函数成功,则函数返回非零值。

如果函数失败,则返回零。 要获得更多的错误信息,请调用 GetLastError。

注解

LookupPrivilegeValue 函数仅支持 Winnt.h 的 Defined Privileges 节中指定的特权。 有关值的列表,请参阅 特权常量

示例

有关使用此函数的示例,请参阅 启用和禁用特权

注意

winbase.h 标头将 LookupPrivilegeValue 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

要求
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

访问控制

基本访问控制函数

LookupPrivilegeDisplayName

LookupPrivilegeName