Fungsi BuildTrusteeWithObjectsAndNameA (aclapi.h)

Artikel
11/20/2024

Fungsi BuildTrusteeWithObjectsAndName menginisialisasi struktur TRUSTEE dengan informasi entri kontrol akses khusus objek (ACE) dan menginisialisasi anggota struktur yang tersisa ke nilai default. Pemanggil juga menentukan nama wali.

Sintaksis

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 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 untuk 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.

Mengembalikan nilai

Tidak

Komentar

Fungsi ini tidak mengalokasikan memori untuk TRUSTEE dan struktur OBJECTS_AND_NAME.

Untuk informasi selengkapnya tentang ACE khusus objek, lihat ACE khusus Objek.

Nota

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