Fungsi RtlGetGroupSecurityDescriptor (ntifs.h)

  • Artikel

Rutinitas RtlGetGroupSecurityDescriptor mengembalikan informasi grup utama untuk deskriptor keamanan tertentu.

Sintaks

NTSYSAPI NTSTATUS RtlGetGroupSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PSID                 *Group,
  [out] PBOOLEAN             GroupDefaulted
);

Parameter

[in] SecurityDescriptor

Arahkan ke deskriptor keamanan yang informasi grup utamanya akan dikembalikan.

[out] Group

Penunjuk ke variabel yang menerima penunjuk ke pengidentifikasi keamanan (SID) untuk grup utama. Jika deskriptor keamanan tidak berisi grup utama, *Grup menerima NULL.

[out] GroupDefaulted

Penunjuk ke variabel Boolean yang menerima nilai bendera SE_GROUP_DEFAULTED dalam struktur SECURITY_DESCRIPTOR_CONTROL deskriptor keamanan. Nilai ini hanya valid jika *Grup menerima nilai non-NULL.

Nilai kembali

RtlGetGroupSecurityDescriptor mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti berikut ini:

Menampilkan kode Deskripsi
STATUS_UNKNOWN_REVISION
 Tingkat revisi deskriptor keamanan tidak diketahui atau tidak didukung. Ini adalah kode kesalahan.

Keterangan

Jika deskriptor keamanan yang ditunjukkan oleh SecurityDescriptor berisi grup utama, RtlGetGroupSecurityDescriptor mengatur penunjuk yang ditunjukkan oleh Grup ke alamat SID grup deskriptor keamanan dan mengatur variabel yang ditunjukkan oleh GroupDefaulted ke nilai yang valid.

Jika deskriptor keamanan yang ditunjukkan oleh SecurityDescriptor tidak berisi grup utama, RtlGetGroupSecurityDescriptor mengatur penunjuk yang ditunjukkan oleh Grup ke NULL dan mengabaikan parameter output yang tersisa, GroupDefaulted.

Untuk mengatur informasi grup utama untuk deskriptor keamanan, gunakan RtlSetGroupSecurityDescriptor.

Untuk mengambil informasi pemilik untuk deskriptor keamanan, gunakan RtlGetOwnerSecurityDescriptor.

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
IRQL <= APC_LEVEL

Lihat juga

RtlGetOwnerSecurityDescriptor

RtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

SID