通过

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 的 Defined Privileges 节中指定的特权。 有关值列表，请参阅 Privilege Constants。

例子

有关使用此函数的示例，请参阅 启用和禁用权限。

注意

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

要求

要求 价值
最低支持的客户端 Windows XP [桌面应用 |UWP 应用]
支持的最低服务器 Windows Server 2003 [桌面应用 |UWP 应用]
目标平台 窗户
标头 winbase.h （包括 Windows.h）
库 Advapi32.lib
DLL Advapi32.dll

另请参阅

访问控制

基本访问控制函数

LookupPrivilegeDisplayName

LookupPrivilegeName