Fungsi NetGroupGetInfo (lmaccess.h)
Fungsi NetGroupGetInfo mengambil informasi tentang grup global tertentu dalam database keamanan, yang merupakan database manajer akun keamanan (SAM) atau, dalam kasus pengontrol domain, Direktori Aktif.
Sintaks
NET_API_STATUS NET_API_FUNCTION NetGroupGetInfo(
[in] LPCWSTR servername,
[in] LPCWSTR groupname,
[in] DWORD level,
[out] LPBYTE *bufptr
);
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 mengambil 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 |
---|---|
|
Mengembalikan nama grup global. Parameter bufptr menunjuk ke struktur GROUP_INFO_0 . |
|
Mengembalikan nama grup global dan komentar. Parameter bufptr menunjuk ke struktur GROUP_INFO_1 . |
|
Mengembalikan informasi terperinci tentang grup global. Parameter bufptr menunjuk ke struktur GROUP_INFO_2 . Perhatikan bahwa pada Windows XP dan yang lebih baru, disarankan agar Anda menggunakan GROUP_INFO_3 sebagai gantinya. |
|
Mengembalikan informasi terperinci tentang grup global. Parameter bufptr menunjuk ke struktur GROUP_INFO_3 .
Windows 2000: Tingkat ini tidak didukung. |
[out] bufptr
Arahkan ke alamat buffer yang menerima struktur informasi grup global. Format data ini tergantung pada nilai parameter tingkat . Sistem mengalokasikan memori untuk buffer ini. Anda harus memanggil fungsi NetApiBufferFree untuk membatalkan alokasi memori. Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan dan Panjang Buffer Fungsi Manajemen Jaringan.
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 |
---|---|
|
Pengguna tidak memiliki akses ke informasi yang diminta. |
|
Nama komputer tidak valid. |
|
Nama grup global tidak dapat ditemukan. |
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 mengizinkan semua pengguna terautentikasi dan anggota grup "Akses pra-Windows 2000 kompatibel" untuk melihat informasi. Jika Anda memanggil fungsi ini di server anggota atau stasiun kerja, semua pengguna yang diautentikasi dapat melihat informasi. Untuk informasi tentang akses anonim dan membatasi akses anonim pada platform ini, 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.
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk