LsaEnumerateAccountRights 函数 (ntsecapi.h)
LsaEnumerateAccountRights 函数枚举分配给帐户的权限。
语法
NTSTATUS LsaEnumerateAccountRights(
[in] LSA_HANDLE PolicyHandle,
[in] PSID AccountSid,
[out] PLSA_UNICODE_STRING *UserRights,
[out] PULONG CountOfRights
);
参数
[in] PolicyHandle
Policy 对象的句柄。 句柄必须具有POLICY_LOOKUP_NAMES访问权限。 有关详细信息,请参阅 打开策略对象句柄。
[in] AccountSid
指向要枚举其权限的帐户的 SID 的指针。
[out] UserRights
接收指向 LSA_UNICODE_STRING 结构的数组的指针。 每个结构都包含帐户拥有的权限的名称。 有关特权名称的列表,请参阅 Privilege Constants
如果不再需要这些信息,请将返回的指针传递给 LsaFreeMemory。
[out] CountOfRights
指向一个变量的指针,该变量接收 UserRights 数组中的特权数。
返回值
如果找到至少一个帐户权限,则函数会成功并返回STATUS_SUCCESS。
如果未找到帐户权限,或者函数因任何其他原因而失败,则函数将返回 NTSTATUS 代码,例如FILE_NOT_FOUND。 有关详细信息,请参阅 LSA 策略函数返回值。 使用 LsaNtStatusToWinError 函数将 NTSTATUS 代码转换为 Windows 错误代码。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | ntsecapi.h |
Library | Advapi32.lib |
DLL | Advapi32.dll |