struktur ACE_HEADER (winnt.h)

Artikel
03/08/2023

Struktur ACE_HEADER mendefinisikan jenis dan ukuran entri kontrol akses (ACE).

Sintaks

typedef struct _ACE_HEADER {
  BYTE AceType;
  BYTE AceFlags;
  WORD AceSize;
} ACE_HEADER;

Anggota

AceType

Menentukan jenis ACE. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
ACCESS_ALLOWED_ACE_TYPE	ACE yang diizinkan akses yang menggunakan struktur ACCESS_ALLOWED_ACE .
ACCESS_ALLOWED_CALLBACK_ACE_TYPE	ACE panggilan balik yang diizinkan akses yang menggunakan struktur ACCESS_ALLOWED_CALLBACK_ACE .
ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE	ACE panggilan balik khusus akses khusus objek yang menggunakan struktur ACCESS_ALLOWED_CALLBACK_OBJECT_ACE .
ACCESS_ALLOWED_COMPOUND_ACE_TYPE	Dicadangkan.
ACCESS_ALLOWED_OBJECT_ACE_TYPE	ACE yang diizinkan akses khusus objek yang menggunakan struktur ACCESS_ALLOWED_OBJECT_ACE .
ACCESS_DENIED_ACE_TYPE	ACE yang ditolak akses yang menggunakan struktur ACCESS_DENIED_ACE .
ACCESS_DENIED_CALLBACK_ACE_TYPE	ACE panggilan balik yang ditolak akses yang menggunakan struktur ACCESS_DENIED_CALLBACK_ACE .
ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE	ACE panggilan balik khusus akses khusus objek ditolak yang menggunakan struktur ACCESS_DENIED_CALLBACK_OBJECT_ACE .
ACCESS_DENIED_OBJECT_ACE_TYPE	ACE yang ditolak akses khusus objek yang menggunakan struktur ACCESS_DENIED_OBJECT_ACE .
ACCESS_MAX_MS_ACE_TYPE	Sama seperti SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MAX_MS_V2_ACE_TYPE	Sama seperti SYSTEM_ALARM_ACE_TYPE.
ACCESS_MAX_MS_V3_ACE_TYPE	Dicadangkan.
ACCESS_MAX_MS_V4_ACE_TYPE	Sama seperti SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MAX_MS_OBJECT_ACE_TYPE	Sama seperti SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MIN_MS_ACE_TYPE	Sama seperti ACCESS_ALLOWED_ACE_TYPE.
ACCESS_MIN_MS_OBJECT_ACE_TYPE	Sama seperti ACCESS_ALLOWED_OBJECT_ACE_TYPE.
SYSTEM_ALARM_ACE_TYPE	Disiapkan untuk penggunaan masa mendatang. ACE alarm sistem yang menggunakan struktur SYSTEM_ALARM_ACE .
SYSTEM_ALARM_CALLBACK_ACE_TYPE	Disiapkan untuk penggunaan masa mendatang. ACE panggilan balik alarm sistem yang menggunakan struktur SYSTEM_ALARM_CALLBACK_ACE .
SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE	Disiapkan untuk penggunaan masa mendatang. ACE panggilan balik alarm sistem khusus objek yang menggunakan struktur SYSTEM_ALARM_CALLBACK_OBJECT_ACE .
SYSTEM_ALARM_OBJECT_ACE_TYPE	Disiapkan untuk penggunaan masa mendatang. ACE alarm sistem khusus objek yang menggunakan struktur SYSTEM_ALARM_OBJECT_ACE .
SYSTEM_AUDIT_ACE_TYPE	ACE audit sistem yang menggunakan struktur SYSTEM_AUDIT_ACE .
SYSTEM_AUDIT_CALLBACK_ACE_TYPE	ACE panggilan balik audit sistem yang menggunakan struktur SYSTEM_AUDIT_CALLBACK_ACE .
SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE	ACE panggilan balik audit sistem khusus objek yang menggunakan struktur SYSTEM_AUDIT_CALLBACK_OBJECT_ACE .
SYSTEM_AUDIT_OBJECT_ACE_TYPE	ACE audit sistem khusus objek yang menggunakan struktur SYSTEM_AUDIT_OBJECT_ACE .
SYSTEM_MANDATORY_LABEL_ACE_TYPE 0x11	ACE label wajib yang menggunakan struktur SYSTEM_MANDATORY_LABEL_ACE .

AceFlags

Menentukan sekumpulan bendera kontrol khusus jenis ACE. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
CONTAINER_INHERIT_ACE	Objek anak yang merupakan kontainer, seperti direktori, mewarisi ACE sebagai ACE yang efektif. ACE yang diwariskan dapat diwariskan kecuali bendera bit NO_PROPAGATE_INHERIT_ACE juga diatur.
FAILED_ACCESS_ACE_FLAG	Digunakan dengan ACE audit sistem dalam daftar kontrol akses sistem (SACL) untuk menghasilkan pesan audit untuk upaya akses yang gagal.
INHERIT_ONLY_ACE	Menunjukkan ACE khusus warisan, yang tidak mengontrol akses ke objek yang dilampirkan. Jika bendera ini tidak diatur, ACE adalah ACE efektif yang mengontrol akses ke objek yang dilampirkan. ACE yang efektif dan khusus warisan dapat diwariskan tergantung pada status bendera pewarisan lainnya.
INHERITED_ACE	Menunjukkan bahwa ACE diwariskan. Sistem mengatur bit ini ketika menyebarkan ACE yang diwariskan ke objek anak.
NO_PROPAGATE_INHERIT_ACE	Jika ACE diwarisi oleh objek anak, sistem akan menghapus bendera OBJECT_INHERIT_ACE dan CONTAINER_INHERIT_ACE di ACE yang diwariskan. Ini mencegah ACE diwarisi oleh generasi objek berikutnya.
OBJECT_INHERIT_ACE	Objek turunan nonkontainer mewarisi ACE sebagai ACE yang efektif. Untuk objek anak yang merupakan kontainer, ACE diwarisi sebagai ACE khusus warisan kecuali bendera bit NO_PROPAGATE_INHERIT_ACE juga diatur.
SUCCESSFUL_ACCESS_ACE_FLAG	Digunakan dengan ACE audit sistem dalam SACL untuk menghasilkan pesan audit untuk upaya akses yang berhasil.

AceSize

Menentukan ukuran, dalam byte, dari ACE.

Keterangan

Struktur ACE_HEADER adalah anggota pertama dari berbagai jenis struktur ACE, seperti ACCESS_ALLOWED_ACE.

ACE alarm sistem saat ini tidak didukung. Anggota AceType tidak dapat menentukan nilai SYSTEM_ALARM_ACE_TYPE atau SYSTEM_ALARM_OBJECT_ACE_TYPE. Jangan gunakan struktur SYSTEM_ALARM_ACE atau SYSTEM_ALARM_OBJECT_ACE .

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	winnt.h (termasuk Windows.h)