Fungsi LsaAddAccountRights (ntsecapi.h)

Fungsi LsaAddAccountRights menetapkan satu atau beberapa hak istimewa ke akun. Jika akun tidak ada, LsaAddAccountRights membuatnya.

Sintaks

NTSTATUS LsaAddAccountRights(
  [in] LSA_HANDLE          PolicyHandle,
  [in] PSID                AccountSid,
  [in] PLSA_UNICODE_STRING UserRights,
  [in] ULONG               CountOfRights
);

Parameter

[in] PolicyHandle

Handel ke objek Policy . Handel harus memiliki hak akses POLICY_LOOKUP_NAMES. Jika akun yang diidentifikasi oleh parameter AccountSid tidak ada, handel harus memiliki hak akses POLICY_CREATE_ACCOUNT. Untuk informasi selengkapnya, lihat Membuka Penanganan Objek Kebijakan.

[in] AccountSid

Arahkan ke SID akun tempat fungsi menetapkan hak istimewa.

[in] UserRights

Penunjuk ke array struktur LSA_UNICODE_STRING . Setiap struktur berisi nama hak istimewa untuk ditambahkan ke akun. Untuk daftar nama hak istimewa, lihat Privilege Constants.

[in] CountOfRights

Menentukan jumlah elemen dalam array UserRights .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah STATUS_SUCCESS.

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

Menampilkan kode	Deskripsi
STATUS_NO_SUCH_PRIVILEGE	Salah satu nama hak istimewa tidak valid.

 

Anda dapat menggunakan fungsi LsaNtStatusToWinError untuk mengonversi kode NTSTATUS ke kode kesalahan Windows.

Keterangan

Jika Anda menentukan hak istimewa yang sudah diberikan ke akun, hak istimewa tersebut akan diabaikan.

Untuk contoh yang menunjukkan pemanggilan fungsi ini, lihat Mengelola Izin Akun.

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

LsaEnumerateAccountRights

LsaRemoveAccountRights