Fungsi LsaEnumerateAccountsWithUserRight (ntsecapi.h)

Artikel
03/15/2023

Fungsi LsaEnumerateAccountsWithUserRight mengembalikan akun dalam database objek Kebijakan Otoritas Keamanan Lokal (LSA) yang memiliki hak istimewa tertentu. Akun yang dikembalikan oleh fungsi ini memegang hak istimewa yang ditentukan langsung melalui akun pengguna, bukan sebagai bagian dari keanggotaan ke grup.

Sintaks

NTSTATUS LsaEnumerateAccountsWithUserRight(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING UserRight,
  [out] PVOID               *Buffer,
  [out] PULONG              CountReturned
);

Parameter

[in] PolicyHandle

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

[in] UserRight

Penunjuk ke struktur LSA_UNICODE_STRING yang menentukan nama hak istimewa. Untuk daftar hak istimewa, lihat Konstanta Hak Istimewa dan Konstanta Hak Akun.

Jika parameter ini ADALAH NULL, fungsi menghitung semua akun dalam database LSA sistem yang terkait dengan objek Policy .

[out] Buffer

Penunjuk ke variabel yang menerima penunjuk ke array struktur LSA_ENUMERATION_INFORMATION . Anggota Sid dari setiap struktur adalah penunjuk ke pengidentifikasi keamanan (SID) akun yang memegang hak istimewa yang ditentukan.

Ketika Anda tidak lagi membutuhkan informasi, bebaskan memori dengan meneruskan pointer yang dikembalikan ke fungsi LsaFreeMemory .

[out] CountReturned

Penunjuk ke variabel yang menerima jumlah entri yang dikembalikan dalam parameter EnumerationBuffer .

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan STATUS_SUCCESS.

Jika fungsi gagal, fungsi mengembalikan kode NTSTATUS , yang dapat menjadi salah satu nilai berikut atau salah satu Nilai Pengembalian Fungsi Kebijakan LSA.

Nilai	Deskripsi
STATUS_NO_SUCH_PRIVILEGE	String hak istimewa yang ditentukan bukan hak istimewa yang valid.
STATUS_NO_MORE_ENTRIES	Tidak ada akun dengan hak istimewa yang ditentukan.

Anda dapat menggunakan 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_ENUMERATION_INFORMATION

LSA_UNICODE_STRING

LsaFreeMemory

LsaOpenPolicy

Bagikan melalui