Fungsi RtlAddAccessAllowedAce (ntifs.h)

Artikel
02/26/2024

Rutinitas RtlAddAccessAllowedAce menambahkan entri kontrol akses yang diizinkan akses (ACE) ke daftar kontrol akses (ACL). Akses diberikan kepada pengidentifikasi keamanan (SID) yang ditentukan.

Sintaks

NTSYSAPI NTSTATUS RtlAddAccessAllowedAce(
  [in, out] PACL        Acl,
  [in]      ULONG       AceRevision,
  [in]      ACCESS_MASK AccessMask,
  [in]      PSID        Sid
);

Parameter

[in, out] Acl

Penunjuk ke buffer yang dialokasikan penelepon yang berisi ACL yang akan dimodifikasi. RtlAddAccessAllowedAce menambahkan ACE yang diizinkan akses ke akhir ACL ini. ACE dalam bentuk struktur ACCESS_ALLOWED_ACE.

[in] AceRevision

Tingkat revisi ACL ACE yang akan ditambahkan. Persyaratan versi Windows adalah sebagai berikut:

Nilai	Makna
ACL_REVISION	Tingkat revisi valid pada semua versi Windows.
ACL_REVISION_DS	Tingkat revisi valid dimulai dengan Windows 2000. CatatanAceRevision harus ACL_REVISION_DS jika ACL di Acl berisi ACE khusus objek.

[in] AccessMask

Bitmask dari satu atau beberapa bendera ACCESS_MASK yang menentukan hak akses yang akan diberikan kepada SID yang ditentukan. Untuk informasi selengkapnya, lihat deskripsi parameter DesiredAccess dari ZwCreateFile.

[in] Sid

Penunjuk ke struktur SID yang mewakili pengguna, grup, atau akun masuk yang diberikan akses.

Mengembalikan nilai

RtlAddAccessAllowedAce dapat mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	ACE berhasil ditambahkan.
STATUS_ALLOTTED_SPACE_EXCEEDED	ACE baru tidak cocok dengan ACL. Buffer ACL yang lebih besar diperlukan. Lihat RtlCreateAcl untuk informasi tentang menghitung ukuran ACL.
STATUS_INVALID_ACL	ACL yang ditentukan tidak terbentuk dengan benar.
STATUS_INVALID_SID	Struktur SID yang ditentukan tidak valid secara struktural.
STATUS_REVISION_MISMATCH	Revisi yang ditentukan tidak diketahui atau tidak kompatibel dengan ACL.

Keterangan

Untuk informasi selengkapnya tentang keamanan dan kontrol akses, lihat Model keamanan Windows untuk pengembang driver dan dokumentasi tentang topik ini di Windows SDK.