Bagikan melalui


Fungsi NetLocalGroupAdd (lmaccess.h)

Fungsi NetLocalGroupAdd membuat grup lokal dalam database keamanan, yang merupakan database manajer akun keamanan (SAM) atau, dalam kasus pengendali domain, Direktori Aktif.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetLocalGroupAdd(
  [in]  LPCWSTR servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parameter

[in] servername

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

[in] level

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

Nilai Makna
0
Nama grup lokal. Parameter buf menunjuk ke struktur LOCALGROUP_INFO_0 .
1
Nama grup lokal dan komentar untuk dikaitkan dengan grup. Parameter buf menunjuk ke struktur LOCALGROUP_INFO_1 .

[in] buf

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

[out] parm_err

Penunjuk ke nilai yang menerima indeks anggota pertama struktur informasi grup lokal menyebabkan kesalahan ERROR_INVALID_PARAMETER. Jika parameter ini NULL, indeks tidak dikembalikan pada kesalahan. Untuk informasi selengkapnya, lihat bagian Keterangan di topik NetLocalGroupSetInfo .

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success.

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

Menampilkan kode Deskripsi
ERROR_ACCESS_DENIED
Pemanggil tidak memiliki akses yang sesuai untuk menyelesaikan operasi.
ERROR_ALIAS_EXISTS
Grup lokal yang ditentukan sudah ada. Kesalahan ini dikembalikan jika anggota nama grup dalam struktur yang ditunjukkan oleh parameter buf sudah digunakan sebagai alias.
ERROR_INVALID_LEVEL
Parameter tingkat tidak valid.
ERROR_INVALID_PARAMETER
Parameter salah. Kesalahan ini dikembalikan jika satu atau beberapa anggota dalam struktur yang ditujukkan oleh parameter buf tidak valid.
NERR_GroupExists
Nama grup ada. Kesalahan ini dikembalikan jika anggota nama grup dalam struktur yang diacu oleh parameter buf sudah digunakan sebagai nama grup.
NERR_InvalidComputer
Nama komputer tidak valid.
NERR_NotPrimary
Operasi hanya diperbolehkan pada pengendali domain utama domain.
NERR_UserExists
Nama pengguna ada. Kesalahan ini dikembalikan jika anggota nama grup dalam struktur yang diacu oleh parameter buf sudah digunakan sebagai nama pengguna.

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 kontainer pengguna digunakan untuk melakukan pemeriksaan akses untuk fungsi ini. Pemanggil harus dapat membuat objek anak dari kelas grup.

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 fungsi NetLocalGroupAdd mengembalikan ERROR_INVALID_PARAMETER dan penunjuk NULL tidak diteruskan dalam parameter parm_err , mengembalikan parameter parm_err menunjukkan anggota pertama struktur informasi grup lokal yang tidak valid. Format struktur informasi grup lokal ditentukan dalam parameter tingkat . Penunjuk ke struktur informasi grup lokal diteruskan dalam parameter buf . Tabel berikut ini mencantumkan nilai yang bisa dikembalikan dalam parameter parm_err dan anggota struktur terkait yang bermasalah.

Nilai Anggota
LOCALGROUP_NAME_PARMNUM Jika parameter tingkat adalah 0, lgrpi0_name anggota struktur LOCALGROUP_INFO_0 tidak valid.

Jika parameter tingkat adalah 1 , lgrpi1_name anggota struktur LOCALGROUP_INFO_1 tidak valid.

LOCALGROUP_COMMENT_PARMNUM Jika parameter tingkat adalah 1, lgrpi1_comment anggota struktur LOCALGROUP_INFO_1 tidak valid.
 

Saat membuat permintaan ke pengendali domain dan Direktori Aktif, Anda mungkin dapat memanggil metode Antarmuka Layanan Direktori Aktif (ADSI) tertentu untuk mencapai hasil yang sama dengan fungsi grup lokal 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

Lihat juga

LOCALGROUP_INFO_0

LOCALGROUP_INFO_1

Fungsi Grup Lokal

NetLocalGroupAddMembers

NetLocalGroupDel

NetLocalGroupSetInfo

Fungsi Manajemen Jaringan

Gambaran Umum Manajemen Jaringan

Buffer Fungsi Manajemen Jaringan