Fungsi NetLocalGroupSetInfo (lmaccess.h)

Artikel
08/24/2023

Fungsi NetLocalGroupSetInfo mengubah nama grup lokal yang ada. Fungsi ini juga mengaitkan komentar dengan grup lokal.

Sintaks

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

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

Arahkan ke string konstanta yang menentukan nama akun grup lokal yang akan diubah. 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 nama grup lokal. Parameter buf menunjuk ke struktur LOCALGROUP_INFO_0 . Gunakan tingkat ini untuk mengubah nama grup lokal yang ada.
1	Menentukan nama grup lokal dan komentar untuk dikaitkan dengan grup. Parameter buf menunjuk ke struktur LOCALGROUP_INFO_1 .
1002	Menentukan komentar untuk dikaitkan dengan grup lokal. Parameter buf menunjuk ke struktur LOCALGROUP_INFO_1002 .

[in] buf

Penunjuk ke buffer yang berisi 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 yang menyebabkan kesalahan ERROR_INVALID_PARAMETER. Jika parameter ini NULL, indeks tidak dikembalikan pada kesalahan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

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
ERROR_ACCESS_DENIED	Pengguna tidak memiliki akses ke informasi yang diminta.
ERROR_INVALID_PARAMETER	Salah satu parameter fungsi tidak valid. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
ERROR_NO_SUCH_ALIAS	Grup lokal yang ditentukan tidak ada.
NERR_NotPrimary	Operasi hanya diperbolehkan pada pengendali domain utama domain.
NERR_InvalidComputer	Nama komputer tidak valid.

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. Biasanya, penelepon harus memiliki akses tulis ke seluruh objek agar panggilan ke fungsi ini berhasil.

Untuk menentukan nama baru grup lokal yang sudah ada, panggil NetLocalGroupSetInfo dengan LOCALGROUP_INFO_0 dan tentukan nilai menggunakan anggota lgrpi0_name . Jika Anda memanggil fungsi NetLocalGroupSetInfo dengan LOCALGROUP_INFO_1 dan menentukan nilai baru menggunakan anggota lgrpi1_name , nilai tersebut akan diabaikan.

Jika fungsi NetLocalGroupSetInfo mengembalikan ERROR_INVALID_PARAMETER, Anda dapat menggunakan parameter parm_err untuk menunjukkan anggota pertama struktur informasi grup lokal yang tidak valid. (Struktur informasi grup lokal dimulai dengan LOCALGROUP_INFO_ dan formatnya ditentukan oleh parameter tingkat .) Tabel berikut mencantumkan nilai yang bisa dikembalikan dalam parameter parm_err dan anggota struktur terkait yang bermasalah. (Awalan lgrpi*_ menunjukkan bahwa anggota dapat dimulai dengan beberapa awalan, misalnya, lgrpi0_ atau lgrpi1_.)

Nilai	Anggota
LOCALGROUP_NAME_PARMNUM	lgrpi*_name
LOCALGROUP_COMMENT_PARMNUM	lgrpi*_comment

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