Fungsi RtlSetGroupSecurityDescriptor (ntifs.h)
Rutinitas RtlSetGroupSecurityDescriptor mengatur informasi grup utama deskriptor keamanan format absolut. Ini menggantikan informasi grup utama yang sudah ada di deskriptor keamanan.
Sintaks
NTSYSAPI NTSTATUS RtlSetGroupSecurityDescriptor(
[in, out] PSECURITY_DESCRIPTOR SecurityDescriptor,
[in, optional] PSID Group,
[in, optional] BOOLEAN GroupDefaulted
);
Parameter
[in, out] SecurityDescriptor
Arahkan ke struktur SECURITY_DESCRIPTOR yang grup utamanya akan diatur. RtlSetGroupSecurityDescriptor menggantikan grup utama yang ada dengan grup utama baru.
[in, optional] Group
Arahkan ke struktur pengidentifikasi keamanan (SID) untuk pemilik utama baru deskriptor keamanan. Penunjuk ini, bukan struktur SID itu sendiri, disalin ke dalam deskriptor keamanan. Jika GrupNULL, RtlSetGroupSecurityDescriptor akan menghapus informasi grup utama deskriptor keamanan. Ini menandai deskriptor keamanan sebagai tidak memiliki grup utama.
[in, optional] GroupDefaulted
Atur variabel Boolean ini ke TRUE jika informasi grup utama berasal dari mekanisme default. Jika parameter ini TRUE, RtlSetGroupSecurityDescriptor mengatur bendera SE_GROUP_DEFAULTED di bidang SECURITY_DESCRIPTOR_CONTROL pendeskripsi keamanan. Jika parameter ini FALSE, RtlSetGroupSecurityDescriptor menghapus bendera SE_GROUP_DEFAULTED.
Nilai kembali
RtlSetGroupSecurityDescriptor mengembalikan STATUS_SUCCESS jika grup utama berhasil diatur atau direset. Jika tidak, ia mengembalikan nilai NTSTATUS yang sesuai seperti salah satu hal berikut ini:
Menampilkan kode | Deskripsi |
---|---|
|
Deskriptor keamanan yang diberikan bukan pendeskripsi keamanan absolut yang valid. STATUS_INVALID_SECURITY_DESCR adalah kode kesalahan. |
|
Revisi deskriptor keamanan yang diberikan tidak dikenali oleh rutinitas ini. STATUS_UNKNOWN_REVISION adalah kode kesalahan. |
Keterangan
Untuk mengambil informasi grup utama untuk deskriptor keamanan, gunakan RtlGetGroupSecurityDescriptor.
Untuk mengatur informasi pemilik untuk deskriptor keamanan, gunakan RtlSetOwnerSecurityDescriptor.
Untuk informasi selengkapnya tentang keamanan dan kontrol akses, lihat dokumentasi Microsoft Windows SDK.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Server 2003 SP1 |
Target Platform | Universal |
Header | ntifs.h (termasuk Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe (mode kernel); Ntdll.dll (mode pengguna) |
IRQL | <= APC_LEVEL |