Fungsi NetGroupAddUser (lmaccess.h)
Fungsi NetGroupAddUser memberikan keanggotaan akun pengguna yang ada di grup global yang ada dalam database keamanan, yang merupakan database manajer akun keamanan (SAM) atau, dalam kasus pengendali domain, Direktori Aktif.
Sintaks
NET_API_STATUS NET_API_FUNCTION NetGroupAddUser(
[in] LPCWSTR servername,
[in] LPCWSTR GroupName,
[in] LPCWSTR username
);
Parameter
[in] servername
Penunjuk ke string konstanta yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi akan dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.
[in] GroupName
Penunjuk ke string konstanta yang menentukan nama grup global tempat pengguna akan diberikan keanggotaan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
[in] username
Penunjuk ke string konstanta yang menentukan nama pengguna yang akan diberikan keanggotaan dalam grup global. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
Menampilkan nilai
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 |
---|---|
|
Pengguna tidak memiliki akses ke informasi yang diminta. |
|
Nama komputer tidak valid. |
|
Operasi ini hanya diperbolehkan pada pengendali domain utama domain. |
|
Operasi ini tidak diperbolehkan pada grup khusus tertentu. Grup ini mencakup grup pengguna, grup admin, grup lokal, dan grup tamu. |
|
Nama pengguna tidak dapat ditemukan. |
|
Nama grup global 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.
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
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 |