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