LookupPrivilegeDisplayName函数检索表示指定权限的可显示名称。
BOOL LookupPrivilegeDisplayName(
LPCTSTR 【lpSystemName】, | //指向系统的字符串指针 |
LPCTSTR 【lpName】, | //指向特权字符串的指针 |
LPTSTR 【lpDisplayName】, | //指向接收可显示名称的字符串的指针 |
LPDWORD 【cbDisplayName】, | //指向可显示名称的字符串大小的指针 |
LPDWORD 【lpLanguageId】 | //指向语言标识符的指针 |
); |
参数
【lpSystemName】
指向一个以null结尾的字符串,指定查看可显示特权名称的系统的名称。如果指定了一个空字符串,该函数将尝试在本地系统上查找可显示的名称。
【lpName】
指向一个以空值终止的字符串,指定WINNT.H头文件中定义的特权名称。例如,该参数可以指定常量SE_REMOTE_SHUTDOWN_NAME或其相应的字符串“SeRemoteShutdownPrivilege”。
【lpDisplayName】
指向缓冲区,接收以空值终止的字符串,给出特权的可显示名称。例如,如果【lpName】参数为SE_REMOTE_SHUTDOWN_NAME,则可显示名称为“从远程系统强制关闭”。
【cbDisplayName】
指向一个变量,指定【lpDisplayName】缓冲区的大小(以字符为单位)。当函数返回时,此参数包含可显示特权名称的长度,不包括终止空字符。如果【lpDisplayName】参数指向的缓冲区太小,则该变量在函数返回时包含所需的大小。
【lpLanguageId】
指向接收返回的可显示名称的语言标识符的变量。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
LookupPrivilegeDisplayName函数仅检索WINNT.H“定义特权”部分中指定的权限的显示名称。
也可以看看