Fungsi BuildTrusteeWithObjectsAndNameA (aclapi.h)

Artikel
02/26/2024

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