Fungsi NetGroupSetInfo (lmaccess.h)

Artikel
08/24/2023

Fungsi NetGroupSetInfo menetapkan parameter grup global dalam database keamanan, yang merupakan database manajer akun keamanan (SAM) atau, dalam kasus pengendali domain, Direktori Aktif.

Sintaks

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

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 untuk mengatur informasi. 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 global. Parameter buf menunjuk ke struktur GROUP_INFO_0 .
1	Menentukan nama grup global dan komentar. Parameter buf menunjuk ke struktur GROUP_INFO_1 .
2	Menentukan informasi terperinci tentang grup global. Parameter buf menunjuk ke struktur GROUP_INFO_2 . Perhatikan bahwa pada Windows XP dan yang lebih baru, disarankan agar Anda menggunakan GROUP_INFO_3 sebagai gantinya.
3	Menentukan informasi terperinci tentang grup global. Parameter buf menunjuk ke struktur GROUP_INFO_3 . Windows 2000: Tingkat ini tidak didukung.
1002	Menentukan komentar hanya tentang grup global. Parameter buf menunjuk ke struktur GROUP_INFO_1002 .
1005	Menentukan atribut grup global. Parameter buf menunjuk ke struktur GROUP_INFO_1005 .

Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[in] buf

Penunjuk ke buffer yang berisi data. 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 dalam kesalahan setelah kode 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 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_PARAMETER	Salah satu parameter fungsi tidak valid. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
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_SpeGroupOp	Operasi ini tidak diperbolehkan pada grup khusus tertentu. Grup ini mencakup grup pengguna, grup admin, grup lokal, dan grup tamu.

Keterangan

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.

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

Cara yang benar untuk mengatur nama baru grup global adalah dengan memanggil fungsi NetGroupSetInfo , menggunakan struktur GROUP_INFO_0 . Tentukan nilai baru di anggota grpi0_name . Jika Anda menggunakan struktur GROUP_INFO_1 dan menentukan nilai di anggota grpi1_name , nilai nama baru diabaikan.

Jika fungsi NetGroupSetInfo mengembalikan ERROR_INVALID_PARAMETER, Anda dapat menggunakan parameter parm_err untuk menunjukkan anggota pertama dari struktur informasi grup yang tidak valid. (Struktur informasi grup dimulai dengan GROUP_INFO_ dan formatnya ditentukan oleh parameter tingkat .) Tabel berikut ini mencantumkan nilai yang bisa dikembalikan dalam parameter parm_err dan anggota struktur terkait yang dalam kesalahan. (Awalan grpi*_ menunjukkan bahwa anggota dapat dimulai dengan beberapa awalan, misalnya, grpi1_ atau grpi2_.)

Nilai	Anggota
GROUP_NAME_PARMNUM	grpi*_name
GROUP_COMMENT_PARMNUM	grpi*_comment
GROUP_ATTRIBUTES_PARMNUM	grpi*_attributes

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.

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