LookupPrivilegeDisplayNameA 函数 (winbase.h)

项目
08/27/2023

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”。有关值列表，请参阅 Privilege Constants。

[out, optional] lpDisplayName

指向缓冲区的指针，该缓冲区接收一个以 null 结尾的字符串，该字符串指定特权显示名称。例如，如果 lpName 参数SE_REMOTE_SHUTDOWN_NAME，则特权显示名称为“从远程系统强制关闭”。

[in, out] cchDisplayName

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

[out] lpLanguageId

指向变量的指针，该变量接收返回的显示名称的语言标识符。

返回值

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

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

注解

LookupPrivilegeDisplayName 函数仅检索 Winnt.h 的 Defined Privileges 节中指定的特权的显示名称。

注意

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

要求


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

另请参阅

LookupPrivilegeDisplayNameA 函数 (winbase.h)

语法

参数

返回值

注解

要求

另请参阅

反馈

反馈

其他资源