Fungsi GetInheritanceSourceA (aclapi.h)

Versi fungsi ini tidak didukung. Versi karakter yang luas dari fungsi ini, GetInheritanceSourceW, didukung.

Sintaksis

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

Dipesan. Atur parameter ini ke NULL .

[in] pGenericMapping

Pemetaan hak generik untuk hak tertentu untuk objek.

[out] pInheritArray

Penunjuk ke array struktur INHERITED_FROM yang fungsi GetInheritanceSource diisi dengan informasi pewarisan. Pemanggil harus mengalokasikan memori yang cukup untuk entri untuk setiap ACE di ACL.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

Jika fungsi gagal, fungsi mengembalikan kode kesalahan bukan nol yang ditentukan dalam WinError.h.

Komentar

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 dapat gagal.

Nota

Header aclapi.h mendefinisikan GetInheritanceSource sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	aclapi.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

FreeInheritedFromArray