Share via

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
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

LSA_UNICODE_STRING

LsaAddAccountRights

LsaFreeMemory

LsaRemoveAccountRights