Fungsi LsaRemoveAccountRights (ntsecapi.h)

Artikel
03/05/2024

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
STATUS_NO_SUCH_PRIVILEGE	Salah satu nama hak istimewa tidak valid.
STATUS_INVALID_PARAMETER	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

Lihat juga

LSA_UNICODE_STRING

LsaAddAccountRights

LsaEnumerateAccountRights

Share via