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

另请参阅

LSA_UNICODE_STRING

LsaAddAccountRights

LsaFreeMemory

LsaRemoveAccountRights