Fungsi GetInheritanceSourceA (aclapi.h)
Versi fungsi ini tidak didukung. Versi karakter yang luas dari fungsi ini, GetInheritanceSourceW, didukung.
Sintaks
DWORD GetInheritanceSourceA(
[in] LPSTR pObjectName,
[in] SE_OBJECT_TYPE ObjectType,
[in] SECURITY_INFORMATION SecurityInfo,
[in] BOOL Container,
[in, optional] GUID **pObjectClassGuids,
[in] DWORD GuidCount,
[in] PACL pAcl,
[in, optional] PFN_OBJECT_MGR_FUNCTS pfnArray,
[in] PGENERIC_MAPPING pGenericMapping,
[out] PINHERITED_FROMA pInheritArray
);
Parameter
[in] pObjectName
Penunjuk ke nama objek yang menggunakan ACL untuk diperiksa.
[in] ObjectType
Jenis objek yang ditunjukkan oleh pObjectName. Nilai yang mungkin adalah SE_FILE_OBJECT, SE_REGISTRY_KEY, SE_DS_OBJECT, dan SE_DS_OBJECT_ALL.
[in] SecurityInfo
Jenis ACL yang digunakan dengan objek . Nilai yang mungkin DACL_SECURITY_INFORMATION atau SACL_SECURITY_INFORMATION.
[in] Container
TRUE jika objek adalah objek kontainer atau FALSE jika objek adalah objek daun. Perhatikan bahwa satu-satunya objek daun adalah SE_FILE_OBJECT.
[in, optional] pObjectClassGuids
Daftar OPSIONAL GUID yang mengidentifikasi jenis objek atau nama yang terkait dengan pObjectName. Ini mungkin NULL jika manajer objek hanya mendukung satu kelas objek atau tidak memiliki GUID yang terkait dengan kelas objek.
[in] GuidCount
Jumlah GUID yang diacu oleh pObjectClassGuids.
[in] pAcl
ACL untuk objek .
[in, optional] pfnArray
Dicadangkan. Atur parameter ini ke NULL.
[in] pGenericMapping
Pemetaan hak generik untuk hak tertentu untuk objek.
[out] pInheritArray
Penunjuk ke array struktur INHERITED_FROM yang diisi fungsi GetInheritanceSource dengan informasi pewarisan. Pemanggil harus mengalokasikan memori yang cukup untuk entri untuk setiap ACE di ACL.
Menampilkan nilai
Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.
Jika fungsi gagal, fungsi mengembalikan kode kesalahan bukan nol yang ditentukan dalam WinError.h.
Keterangan
Fungsi GetInheritanceSource mengalokasikan memori untuk nama yang dikembalikan dalam struktur INHERITED_FROM . Ketika fungsi telah selesai menggunakan memori ini, program panggilan harus membebaskannya dengan memanggil FreeInheritedFromArray. Perhatikan bahwa pemanggil harus menyediakan memori untuk array itu sendiri. Jika penelepon mengalokasikan memori, pemanggil harus membebaskan memori tersebut setelah memanggil FreeInheritedFromArray.
Fungsi ini tidak menangani kondisi balapan. Jika utas Anda memanggil fungsi ini pada perkiraan waktu alur lain mengubah deskriptor keamanan objek, maka fungsi ini bisa gagal.
Catatan
Header aclapi.h mendefinisikan GetInheritanceSource 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 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | aclapi.h |
Pustaka | Advapi32.lib |
DLL | Advapi32.dll |