LookupPrivilegeNameA 函数 (winbase.h)

LookupPrivilegeName 函数通过指定的 本地唯一标识符(LUID)检索与特定系统上所表示的权限对应的名称。

语法

BOOL LookupPrivilegeNameA(
  [in, optional]  LPCSTR  lpSystemName,
  [in]            PLUID   lpLuid,
  [out, optional] LPSTR   lpName,
  [in, out]       LPDWORD cchName
);

参数

[in, optional] lpSystemName

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

[in] lpLuid

指向目标系统上已知特权的 LUID 的指针。

[out, optional] lpName

指向接收表示特权名称的 null 终止字符串的缓冲区的指针。 例如,此字符串可以是“SeSecurityPrivilege”。

[in, out] cchName

指向指定 lpName 缓冲区 TCHAR 值大小的变量的指针。 函数返回时,此参数包含特权名称的长度,不包括终止 null 字符。 如果 lpName 参数指向的缓冲区太小,则此变量包含所需的大小。

返回值

如果函数成功,该函数将返回非零。

如果函数失败,则返回零。 若要获取扩展的错误信息,请调用 GetLastError

言论

LookupPrivilegeName 函数仅支持 Winnt.h 的“已定义特权”部分中指定的特权。 有关值列表,请参阅 Privilege Constants

注意

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

要求

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

另请参阅

访问控制

基本访问控制函数

LookupPrivilegeDisplayName

LookupPrivilegeValue