struktur ACTRL_ACCESS_ENTRYA (accctrl.h)

Artikel
03/14/2023

Berisi informasi kontrol akses untuk wali yang ditentukan. Struktur ini menyimpan informasi yang setara dengan informasi kontrol akses yang disimpan dalam ACE.

Sintaks

typedef struct _ACTRL_ACCESS_ENTRYA {
  TRUSTEE_A     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPSTR         lpInheritProperty;
} ACTRL_ACCESS_ENTRYA, *PACTRL_ACCESS_ENTRYA;

Anggota

Trustee

Struktur TRUSTEE yang mengidentifikasi pengguna, grup, atau program (seperti layanan) tempat entri kontrol akses diterapkan.

fAccessFlags

Menunjukkan bagaimana hak akses yang ditentukan oleh anggota Access dan ProvSpecificAccess berlaku untuk wali amanat. Anggota ini bisa menjadi salah satu nilai berikut. Jika Anda menggunakan struktur ini dengan implementasi COM IAccessControl, anggota ini harus ACTRL_ACCESS_ALLOWED atau ACTRL_ACCESS_DENIED.

Nilai	Makna
ACTRL_ACCESS_ALLOWED 0x00000001	Hak-hak diperbolehkan.
ACTRL_ACCESS_DENIED 0x00000002	Hak ditolak.
ACTRL_AUDIT_SUCCESS 0x00000004	Sistem menghasilkan pesan audit untuk upaya yang gagal menggunakan hak.
ACTRL_AUDIT_FAILURE 0x00000008	Sistem menghasilkan pesan audit untuk upaya yang berhasil menggunakan hak tersebut.

Access

Bitmask yang menentukan hak akses yang diizinkan, ditolak, atau audit entri untuk wali.

Anggota ini harus menggunakan bendera akses independen penyedia, seperti ACTRL_READ_CONTROL, bukan bendera akses seperti READ_CONTROL. Penyedia untuk jenis objek mengonversi bendera independen penyedia ini ke bendera khusus penyedia yang sesuai.

Jika Anda menggunakan struktur ini dengan implementasi COM IAccessControl, anggota ini harus COM_RIGHTS_EXECUTE.

ACTRL_SYSTEM_ACCESS

ACTRL_DELETE

ACTRL_READ_CONTROL

ACTRL_CHANGE_ACCESS

ACTRL_CHANGE_OWNER

ACTRL_SYNCHRONIZE

ACTRL_STD_RIGHTS_ALL

ACTRL_STD_RIGHT_REQUIRED

COM_RIGHTS_EXECUTE

COM_RIGHTS_EXECUTE_LOCAL

COM_RIGHTS_EXECUTE_REMOTE

COM_RIGHTS_ACTIVATE_LOCAL

COM_RIGHTS_ACTIVATE_REMOTE

ProvSpecificAccess

Bitmask yang menentukan hak akses khusus untuk jenis penyedia. Fungsi yang menggunakan struktur ACTRL_ACCESS_ENTRY meneruskan bit ini ke penyedia tanpa menafsirkannya. Dalam kebanyakan kasus, anggota ini harus 0.

Inheritance

Sekumpulan bendera bit yang menentukan apakah kontainer atau objek lain dapat mewarisi entri kontrol akses dari objek utama tempat daftar akses dilampirkan. Jika Anda menggunakan struktur ini dengan implementasi COM IAccessControl, nilai ini harus NO_INHERITANCE, yang menunjukkan bahwa entri kontrol akses tidak dapat diwariskan. Jika tidak, nilai ini bisa NO_INHERITANCE atau bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
CONTAINER_INHERIT_ACE 0x2	Kontainer lain yang dimuat oleh objek utama mewarisi entri.
INHERIT_ONLY_ACE 0x8	ACE tidak berlaku untuk objek utama tempat ACL dilampirkan, tetapi objek yang terkandung oleh objek utama mewarisi entri.
NO_PROPAGATE_INHERIT_ACE 0x4	Bendera OBJECT_INHERIT_ACE dan CONTAINER_INHERIT_ACE tidak disebarkan ke entri yang diwariskan.
OBJECT_INHERIT_ACE 0x1	Objek nonkontainer yang dimuat oleh objek utama mewarisi entri.
SUB_CONTAINERS_AND_OBJECTS_INHERIT 0x3	Baik kontainer maupun objek nonkontainer yang dimuat oleh objek utama mewarisi entri. Bendera ini sesuai dengan kombinasi bendera CONTAINER_INHERIT_ACE dan OBJECT_INHERIT_ACE.
SUB_CONTAINERS_ONLY_INHERIT 0x2	Kontainer lain yang dimuat oleh objek utama mewarisi entri. Bendera ini sesuai dengan bendera CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT 0x1	Objek nonkontainer yang dimuat oleh objek utama mewarisi entri. Bendera ini sesuai dengan bendera OBJECT_INHERIT_ACE.

lpInheritProperty

Penunjuk ke string yang dihentikan null yang mengidentifikasi jenis objek yang dapat mewarisi entri. Jika Anda menggunakan struktur ini dengan implementasi COM dari IAccessControl, anggota ini harus NULL.

Keterangan

Catatan

Header accctrl.h mendefinisikan ACTRL_ACCESS_ENTRY sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	accctrl.h

Lihat juga

ACTRL_ACCESS_ENTRY_LIST

WALI

Bagikan melalui