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 |
---|---|
|
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 |