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 结尾的字符串的指针，该字符串指定检索特权名称的系统的名称。 如果指定了空字符串，则该函数将尝试在本地系统上查找特权名称。

[in] lpLuid

指向 LUID 的指针，该 LUID 在目标系统上的特权是已知的。

[out, optional] lpName

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

[in, out] cchName

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

返回值

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

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

注解

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

注意

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

要求

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

另请参阅

访问控制

基本访问控制函数

LookupPrivilegeDisplayName

LookupPrivilegeValue