struktur ACCESS_DENIED_ACE (winnt.h)

Artikel
03/13/2024

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

Sintaks

typedef struct _ACCESS_DENIED_ACE {
  ACE_HEADER  Header;
  ACCESS_MASK Mask;
  DWORD       SidStart;
} ACCESS_DENIED_ACE;

Anggota

Header

Struktur ACE_HEADER 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_DENIED_ACE_TYPE, dan anggota AceSize harus diatur ke jumlah total byte yang dialokasikan untuk struktur ACCESS_DENIED_ACE .

Mask

Struktur ACCESS_MASK yang menentukan hak akses yang secara eksplisit ditolak 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 ditolak untuk setiap wali yang memiliki SID yang diaktifkan yang cocok dengan SID yang disimpan di anggota SidStart .

Struktur ACCESS_DENIED_ACE dapat dibuat dalam daftar kontrol akses (ACL) dengan panggilan ke fungsi AddAccessDeniedAce atau AddAccessDeniedAceEx . 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 AddAccessDeniedAceEx digunakan, anggota Header.AceFlags juga diatur. Ketika struktur ACCESS_DENIED_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