Fungsi NetLocalGroupAddMembers (lmaccess.h)

Artikel
08/24/2023

Fungsi NetLocalGroupAddMembers menambahkan keanggotaan satu atau beberapa akun pengguna atau akun grup global yang ada ke grup lokal yang sudah ada. Fungsi ini tidak mengubah status keanggotaan pengguna atau grup global yang saat ini menjadi anggota grup lokal.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetLocalGroupAddMembers(
  [in] LPCWSTR servername,
  [in] LPCWSTR groupname,
  [in] DWORD   level,
  [in] LPBYTE  buf,
  [in] DWORD   totalentries
);

Parameter

[in] servername

Arahkan ke string konstanta yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] groupname

Penunjuk ke string konstanta yang menentukan nama grup lokal tempat pengguna atau grup global yang ditentukan akan ditambahkan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[in] level

Menentukan tingkat informasi data. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Menentukan pengidentifikasi keamanan (SID) anggota grup lokal baru. Parameter buf menunjuk ke array struktur LOCALGROUP_MEMBERS_INFO_0 .
3	Menentukan domain dan nama anggota grup lokal baru. Parameter buf menunjuk ke array struktur LOCALGROUP_MEMBERS_INFO_3 .

[in] buf

Arahkan ke buffer yang berisi data untuk anggota grup lokal baru. Format data ini tergantung pada nilai parameter tingkat . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan.

[in] totalentries

Menentukan jumlah entri dalam buffer yang diacu oleh parameter buf .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
NERR_GroupNotFound	Grup lokal yang ditentukan oleh parameter groupname tidak ada.
ERROR_ACCESS_DENIED	Pengguna tidak memiliki akses ke informasi yang diminta.
ERROR_NO_SUCH_MEMBER	Satu atau beberapa anggota yang ditentukan tidak ada. Oleh karena itu, tidak ada anggota baru yang ditambahkan.
ERROR_MEMBER_IN_ALIAS	Satu atau beberapa anggota yang ditentukan sudah menjadi anggota grup lokal. Tidak ada anggota baru yang ditambahkan.
ERROR_INVALID_MEMBER	Satu atau beberapa anggota tidak dapat ditambahkan karena tipe akun mereka tidak valid. Tidak ada anggota baru yang ditambahkan.

Keterangan

Jika Anda memanggil fungsi ini pada pengendali domain yang menjalankan Direktori Aktif, akses diizinkan atau ditolak berdasarkan daftar kontrol akses (ACL) untuk objek yang dapat diamankan. ACL default hanya mengizinkan Admin Domain dan Operator Akun untuk memanggil fungsi ini. Di server anggota atau stasiun kerja, hanya Administrator dan Pengguna Daya yang dapat memanggil fungsi ini. Untuk informasi selengkapnya, lihat Persyaratan Keamanan untuk Fungsi Manajemen Jaringan. Untuk informasi selengkapnya tentang ACL, ACL, dan token akses, lihat Model Access Control.

Deskriptor keamanan objek LocalGroup digunakan untuk melakukan pemeriksaan akses untuk fungsi ini.

Nama akun pengguna dibatasi hingga 20 karakter dan nama grup dibatasi hingga 256 karakter. Selain itu, nama akun tidak dapat dihentikan oleh titik dan tidak dapat menyertakan koma atau salah satu karakter yang dapat dicetak berikut: ", /, , [, ], :, |, <, >, +, =, ;, ?, *. Nama juga tidak dapat menyertakan karakter dalam rentang 1-31, yang tidak dapat dicetak.

Jika Anda memprogram Direktori Aktif, Anda mungkin dapat memanggil metode Antarmuka Layanan Direktori Aktif (ADSI) tertentu untuk mencapai fungsionalitas yang sama yang dapat Anda capai dengan memanggil fungsi grup lokal manajemen jaringan. Untuk informasi selengkapnya, lihat IADsGroup.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	lmaccess.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll