Fungsi GetExplicitEntriesFromAclA (aclapi.h)
Fungsi GetExplicitEntriesFromAcl mengambil array struktur yang menjelaskan entri kontrol akses (ACE) dalam daftar kontrol akses (ACL).
Sintaks
DWORD GetExplicitEntriesFromAclA(
[in] PACL pacl,
[out] PULONG pcCountOfExplicitEntries,
[out] PEXPLICIT_ACCESS_A *pListOfExplicitEntries
);
Parameter
[in] pacl
Penunjuk ke struktur ACL untuk mendapatkan informasi ACE .
[out] pcCountOfExplicitEntries
Penunjuk ke variabel yang menerima jumlah struktur EXPLICIT_ACCESS yang dikembalikan dalam array pListOfExplicitEntries .
[out] pListOfExplicitEntries
Penunjuk ke variabel yang menerima penunjuk ke array struktur EXPLICIT_ACCESS yang menjelaskan ACE dalam ACL. Jika fungsi berhasil, Anda harus memanggil fungsi LocalFree untuk membebaskan buffer yang dikembalikan.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.
Jika fungsi gagal, fungsi mengembalikan kode kesalahan bukan nol yang ditentukan dalam WinError.h.
Keterangan
Setiap entri dalam array struktur EXPLICIT_ACCESS menjelaskan informasi kontrol akses dari ACE untuk wali. Wali bisa menjadi pengguna, grup, atau program (seperti layanan Windows).
Setiap struktur EXPLICIT_ACCESS menentukan sekumpulan hak akses dan bendera mode akses yang menunjukkan apakah ACE mengizinkan, menolak, atau mengaudit hak yang ditentukan.
Untuk daftar kontrol akses diskresi (DACL), bendera mode akses dapat berupa GRANT_ACCESS atau DENY_ACCESS. Untuk informasi tentang nilai-nilai ini, lihat ACCESS_MODE.
Untuk daftar kontrol akses sistem (SACL), bendera mode akses dapat SET_AUDIT_ACCESS, SET_AUDIT_FAILURE, atau keduanya. Untuk informasi tentang nilai-nilai ini, lihat ACCESS_MODE.
Catatan
Header aclapi.h mendefinisikan GetExplicitEntriesFromAcl 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 XP [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | aclapi.h |
Pustaka | Advapi32.lib |
DLL | Advapi32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk