Fungsi LsaEnumerateAccountRights (ntsecapi.h)

Fungsi LsaEnumerateAccountRights menghitung hak istimewa yang ditetapkan ke akun.

Sintaks

NTSTATUS LsaEnumerateAccountRights(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PSID                AccountSid,
  [out] PLSA_UNICODE_STRING *UserRights,
  [out] PULONG              CountOfRights
);

Parameter

[in] PolicyHandle

Handel ke objek Policy . Handel harus memiliki hak akses POLICY_LOOKUP_NAMES. Untuk informasi selengkapnya, lihat Membuka Penanganan Objek Kebijakan.

[in] AccountSid

Arahkan ke SID akun untuk menghitung hak istimewa.

[out] UserRights

Menerima penunjuk ke array struktur LSA_UNICODE_STRING . Setiap struktur berisi nama hak istimewa yang dipegang oleh akun. Untuk daftar nama hak istimewa, lihat Privilege Constants

Ketika Anda tidak lagi memerlukan informasi, berikan penunjuk yang dikembalikan ke LsaFreeMemory.

[out] CountOfRights

Penunjuk ke variabel yang menerima jumlah hak istimewa dalam array UserRights .

Nilai kembali

Jika setidaknya satu hak akun ditemukan, fungsi berhasil dan mengembalikan STATUS_SUCCESS.

Jika tidak ada hak akun yang ditemukan atau jika fungsi gagal karena alasan lain, fungsi mengembalikan kode NTSTATUS seperti FILE_NOT_FOUND. Untuk informasi selengkapnya, lihat Nilai Pengembalian Fungsi Kebijakan LSA. Gunakan fungsi LsaNtStatusToWinError untuk mengonversi kode NTSTATUS ke kode kesalahan Windows.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	ntsecapi.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

LSA_UNICODE_STRING

LsaAddAccountRights

LsaFreeMemory

LsaRemoveAccountRights