Fungsi NetGroupSetUsers (lmaccess.h)

Artikel
02/28/2024

Fungsi NetGroupSetUsers menetapkan keanggotaan untuk grup global yang ditentukan. Setiap pengguna yang Anda tentukan terdaftar sebagai anggota grup global. Pengguna yang tidak Anda tentukan, tetapi yang saat ini menjadi anggota grup global, akan mencabut keanggotaan mereka.

Sintaks

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

Parameter

[in] servername

Penunjuk 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 minat global. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[in] level

Tingkat informasi data. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Parameter buf menunjuk ke array struktur GROUP_USERS_INFO_0 yang menentukan nama pengguna.
1	Parameter buf menunjuk ke array struktur GROUP_USERS_INFO_1 yang menentukan nama pengguna dan atribut grup.

[in] buf

Penunjuk ke buffer yang berisi data. Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan.

[in] totalentries

Jumlah entri dalam buffer yang diacu oleh parameter buf .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

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

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pengguna tidak memiliki akses ke informasi yang diminta.
ERROR_INVALID_LEVEL	Tingkat panggilan sistem tidak benar. Kesalahan ini dikembalikan jika parameter tingkat ditentukan sebagai nilai selain 0 atau 1.
ERROR_INVALID_PARAMETER	Parameter yang diteruskan tidak valid. Kesalahan ini dikembalikan jika parameter totalentries tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia untuk menyelesaikan operasi.
NERR_InvalidComputer	Nama komputer tidak valid.
NERR_NotPrimary	Operasi ini hanya diperbolehkan pada pengendali domain utama domain.
NERR_GroupNotFound	Nama grup global tidak dapat ditemukan.
NERR_InternalError	Terjadi kesalahan internal.
NERR_SpeGroupOp	Operasi ini tidak diperbolehkan pada grup khusus tertentu. Grup ini mencakup grup pengguna, grup admin, grup lokal, dan grup tamu.
NERR_UserNotFound	Nama pengguna tidak dapat ditemukan.

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, ACE, dan token akses, lihat Model Access Control.

Pendeskripsi keamanan objek Grup digunakan untuk melakukan pemeriksaan akses untuk fungsi ini.

Anda dapat mengganti keanggotaan grup global dengan daftar anggota yang sama sekali baru dengan memanggil fungsi NetGroupSetUsers . Urutan langkah-langkah umum untuk melakukan ini sebagai berikut.

Untuk mengganti keanggotaan grup global

Panggil fungsi NetGroupGetUsers untuk mengambil daftar keanggotaan saat ini.
Ubah daftar keanggotaan yang dikembalikan untuk mencerminkan keanggotaan baru.
Panggil fungsi NetGroupSetUsers untuk mengganti daftar keanggotaan lama dengan daftar keanggotaan baru.

Untuk memberikan satu keanggotaan pengguna di grup global yang ada, Anda dapat memanggil fungsi NetGroupAddUser . Untuk menghapus pengguna dari grup global, panggil fungsi NetGroupDelUser .

Nama akun pengguna dibatasi hingga 20 karakter dan nama grup dibatasi hingga 256 karakter. Selain itu, nama akun tidak dapat dihentikan dengan 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 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