Fungsi LsaRemoveAccountRights (ntsecapi.h)
Fungsi LsaRemoveAccountRights menghapus satu atau beberapa hak istimewa dari akun. Anda dapat menentukan hak istimewa yang akan dihapus, atau Anda dapat mengatur bendera untuk menghapus semua hak istimewa. Saat Anda menghapus semua hak istimewa, fungsi akan menghapus akun. Jika Anda menentukan hak istimewa yang tidak dipegang oleh akun, fungsi akan mengabaikannya.
Sintaks
NTSTATUS LsaRemoveAccountRights(
[in] LSA_HANDLE PolicyHandle,
[in] PSID AccountSid,
[in] BOOLEAN AllRights,
[in] PLSA_UNICODE_STRING UserRights,
[in] ULONG 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 pengidentifikasi keamanan (SID) akun tempat hak istimewa dihapus.
[in] AllRights
Jika TRUE, fungsi akan menghapus semua hak istimewa dan menghapus akun. Dalam hal ini, fungsi mengabaikan parameter UserRights . Jika FALSE, fungsi akan menghapus hak istimewa yang ditentukan oleh parameter UserRights .
[in] UserRights
Penunjuk ke array struktur LSA_UNICODE_STRING . Setiap struktur berisi nama hak istimewa yang akan dihapus dari 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 STATUS_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah kode NTSTATUS, yang dapat menjadi salah satu nilai berikut atau salah satu Nilai Pengembalian Fungsi Kebijakan LSA.
Nilai | Deskripsi |
---|---|
|
Salah satu nama hak istimewa tidak valid. |
|
Menunjukkan parameter UserRights adalah NULL dan parameter AllRightsfalse. |
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 |