Fungsi RtlSetGroupSecurityDescriptor (ntifs.h)

  • Artikel

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
STATUS_INVALID_SECURITY_DESCR
 Deskriptor keamanan yang diberikan bukan pendeskripsi keamanan absolut yang valid. STATUS_INVALID_SECURITY_DESCR adalah kode kesalahan.
STATUS_UNKNOWN_REVISION
 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

Lihat juga

RtlGetGroupSecurityDescriptor

RtlSetOwnerSecurityDescriptor

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID