Fungsi BuildTrusteeWithObjectsAndNameA (aclapi.h)
Fungsi BuildTrusteeWithObjectsAndName menginisialisasi struktur TRUSTEE dengan informasi entri kontrol akses (ACE) khusus objek dan menginisialisasi anggota struktur yang tersisa ke nilai default. Pemanggil juga menentukan nama wali amanat.
Sintaks
void BuildTrusteeWithObjectsAndNameA(
[in, out] PTRUSTEE_A pTrustee,
[in, optional] POBJECTS_AND_NAME_A pObjName,
[in, optional] SE_OBJECT_TYPE ObjectType,
[in, optional] LPSTR ObjectTypeName,
[in, optional] LPSTR InheritedObjectTypeName,
[in, optional] LPSTR Name
);
Parameter
[in, out] pTrustee
Penunjuk ke struktur TRUSTEE yang akan diinisialisasi oleh fungsi ini. Jika nilai parameter ini adalah NULL atau pointer yang tidak valid, hasilnya tidak ditentukan.
[in, optional] pObjName
Penunjuk ke struktur OBJECTS_AND_NAME yang berisi informasi tentang wali aman dan objek yang dapat diamankan.
[in, optional] ObjectType
Penunjuk ke enumerasi SE_OBJECT_TYPE yang berisi informasi tentang jenis objek yang dapat diamankan.
[in, optional] ObjectTypeName
Penunjuk ke string yang menentukan nama yang sesuai dengan GUID ObjectType yang akan ditambahkan ke struktur TRUSTEE yang dikembalikan dalam parameter pTrustee . Fungsi ini menentukan GUID ObjectType yang sesuai dengan nama ini.
[in, optional] InheritedObjectTypeName
Penunjuk ke string yang menentukan nama yang sesuai dengan GUID InheritedObjectType yang akan ditambahkan ke struktur TRUSTEE yang dikembalikan dalam parameter pTrustee . Fungsi ini menentukan GUID InheritedObjectType yang sesuai dengan nama ini.
[in, optional] Name
Penunjuk ke string yang menentukan nama yang digunakan untuk mengidentifikasi wali amanat.
Menampilkan nilai
Tidak ada
Keterangan
Fungsi ini tidak mengalokasikan memori untuk struktur TRUSTEE dan OBJECTS_AND_NAME .
Untuk informasi selengkapnya tentang ACE khusus objek, lihat ACE khusus objek.
Catatan
Header aclapi.h mendefinisikan BuildTrusteeWithObjectsAndName 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 |