struktur ACCESS_ALLOWED_ACE (winnt.h)

Artikel
08/27/2023

Struktur ACCESS_ALLOWED_ACE mendefinisikan entri kontrol akses (ACE) untuk daftar kontrol akses diskresi (DACL) yang mengontrol akses ke objek. ACE yang diizinkan akses memungkinkan akses ke objek untuk wali tertentu yang diidentifikasi oleh pengidentifikasi keamanan (SID).

Sintaks

typedef struct _ACCESS_ALLOWED_ACE {
  ACE_HEADER  Header;
  ACCESS_MASK Mask;
  DWORD       SidStart;
} ACCESS_ALLOWED_ACE;

Anggota

Header

ACE_HEADER struktur yang menentukan ukuran dan jenis ACE. Ini juga berisi bendera yang mengontrol pewarisan ACE oleh objek anak. Anggota AceType dari struktur ACE_HEADER harus diatur ke ACCESS_ALLOWED_ACE_TYPE, dan anggota AceSize harus diatur ke jumlah total byte yang dialokasikan untuk struktur ACCESS_ALLOWED_ACE .

Mask

Menentukan struktur ACCESS_MASK yang menentukan hak akses yang diberikan oleh ACE ini.

SidStart

DWORD pertama dari SID wali. Byte SID yang tersisa disimpan dalam memori yang berdampingan setelah anggota SidStart . SID ini dapat ditambahkan dengan data aplikasi.

Keterangan

Struktur ACE harus diselaraskan pada batas DWORD . Semua fungsi manajemen memori Windows mengembalikan handel yang selaras dengan DWORD ke memori.

Hak akses yang ditentukan oleh anggota Mask diberikan kepada setiap wali yang memiliki SID yang diaktifkan yang cocok dengan SID yang disimpan di anggota SidStart .

Struktur ACCESS_ALLOWED_ACE dapat dibuat dalam daftar kontrol akses (ACL) dengan panggilan ke fungsi AddAccessAllowedAce atau AddAccessAllowedAceEx . Ketika fungsi-fungsi ini digunakan, jumlah memori yang benar yang diperlukan untuk mengakomodasi SID wali amanat dialokasikan dan nilai anggota Header.AceType dan Header.AceSize diatur secara otomatis. Jika fungsi AddAccessAllowedAceEx digunakan, anggota Header.AceFlags juga diatur. Ketika struktur ACCESS_ALLOWED_ACE dibuat di luar ACL, memori yang cukup harus dialokasikan untuk mengakomodasi SID lengkap wali amanat di anggota SidStart dan memori yang berdekatan mengikutinya, dan nilai anggota Header.AceType, Header.AceFlags, dan Header.AceSize harus diatur secara eksplisit oleh aplikasi.

Persyaratan

Persyaratan	Nilai
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)

Lihat juga

Bagikan melalui