struktur USER_INFO_11 (lmaccess.h)
Struktur USER_INFO_11 berisi informasi tentang akun pengguna, termasuk nama akun, tingkat hak istimewa, jalur ke direktori beranda pengguna, dan statistik jaringan terkait pengguna lainnya.
Sintaks
typedef struct _USER_INFO_11 {
LPWSTR usri11_name;
LPWSTR usri11_comment;
LPWSTR usri11_usr_comment;
LPWSTR usri11_full_name;
DWORD usri11_priv;
DWORD usri11_auth_flags;
DWORD usri11_password_age;
LPWSTR usri11_home_dir;
LPWSTR usri11_parms;
DWORD usri11_last_logon;
DWORD usri11_last_logoff;
DWORD usri11_bad_pw_count;
DWORD usri11_num_logons;
LPWSTR usri11_logon_server;
DWORD usri11_country_code;
LPWSTR usri11_workstations;
DWORD usri11_max_storage;
DWORD usri11_units_per_week;
PBYTE usri11_logon_hours;
DWORD usri11_code_page;
} USER_INFO_11, *PUSER_INFO_11, *LPUSER_INFO_11;
Anggota
usri11_name
Jenis: LPWSTR
Penunjuk ke karakter Unicode yang menentukan nama akun pengguna. Panggilan ke fungsi NetUserSetInfo mengabaikan anggota ini. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
usri11_comment
Jenis: LPWSTR
Penunjuk ke string Unicode yang berisi komentar yang terkait dengan akun pengguna. String ini dapat berupa string NULL , atau dapat memiliki sejumlah karakter sebelum karakter null dihentikan.
usri11_usr_comment
Jenis: LPWSTR
Penunjuk ke string Unicode yang berisi komentar pengguna. String ini dapat berupa string NULL , atau dapat memiliki sejumlah karakter sebelum karakter null dihentikan.
usri11_full_name
Jenis: LPWSTR
Penunjuk ke string Unicode yang berisi nama lengkap pengguna. String ini dapat berupa string NULL , atau dapat memiliki sejumlah karakter sebelum karakter null dihentikan.
usri11_priv
Jenis: DWORD
Tingkat hak istimewa yang ditetapkan untuk anggota usri11_name . Untuk panggilan ke fungsi NetUserAdd , anggota ini harus USER_PRIV_USER. Untuk panggilan ke NetUserSetInfo, anggota ini harus menjadi nilai yang dikembalikan dari fungsi NetUserGetInfo atau fungsi NetUserEnum . Anggota ini bisa menjadi salah satu nilai berikut. Untuk informasi selengkapnya tentang hak akun pengguna dan grup, lihat Hak Istimewa.
| Nilai | Makna |
|---|---|
|
Tamu |
|
Pengguna |
|
Administrator |
usri11_auth_flags
Jenis: DWORD
Sekumpulan bendera bit yang menentukan hak istimewa operator pengguna.
Panggilan ke fungsi NetUserGetInfo dan fungsi NetUserEnum mengembalikan nilai berdasarkan keanggotaan grup lokal pengguna. Jika pengguna adalah anggota Operator Cetak, AF_OP_PRINT diatur. Jika pengguna adalah anggota Operator Server, AF_OP_SERVER diatur. Jika pengguna adalah anggota Operator Akun, AF_OP_ACCOUNTS diatur. AF_OP_COMM tidak pernah diatur.
Fungsi NetUserAdd dan NetUserSetInfo mengabaikan anggota ini.
Pembatasan berikut berlaku:
- Ketika Anda memanggil fungsi NetUserAdd , anggota ini harus nol.
- Saat Anda memanggil fungsi NetUserSetInfo , anggota ini harus menjadi nilai yang dikembalikan dari panggilan ke NetUserGetInfo atau ke NetUserEnum.
usri11_password_age
Jenis: DWORD
Jumlah detik yang telah berlalu sejak anggota usri11_password terakhir diubah. Fungsi NetUserAdd dan NetUserSetInfo mengabaikan anggota ini.
usri11_home_dir
Jenis: LPWSTR
Penunjuk ke string Unicode yang menentukan jalur direktori beranda untuk pengguna yang ditentukan dalam anggota usri11_name . String dapat null.
usri11_parms
Jenis: LPWSTR
Penunjuk ke string Unicode yang dicadangkan untuk digunakan oleh aplikasi. String ini dapat berupa string NULL , atau dapat memiliki sejumlah karakter sebelum karakter null dihentikan. Produk Microsoft menggunakan anggota ini untuk menyimpan informasi konfigurasi pengguna. Jangan ubah informasi ini.
usri11_last_logon
Jenis: DWORD
Tanggal dan waktu ketika log masuk terakhir terjadi. Nilai ini disimpan sebagai jumlah detik yang telah berlalu sejak 00:00:00, 1 Januari 1970, GMT. Fungsi NetUserAdd dan NetUserSetInfo mengabaikan anggota ini.
Anggota ini dipertahankan secara terpisah pada setiap pengendali domain cadangan (BDC) di domain. Untuk mendapatkan nilai yang akurat, Anda harus mengkueri setiap BDC di domain. Log masuk terakhir terjadi pada saat yang ditunjukkan oleh nilai terbesar yang diambil.
usri11_last_logoff
Jenis: DWORD
Anggota ini saat ini tidak digunakan.
Tanggal dan waktu saat logoff terakhir terjadi. Nilai ini disimpan sebagai jumlah detik yang telah berlalu sejak 00:00:00, 1 Januari 1970, GMT. Nilai nol menunjukkan bahwa waktu keluar terakhir tidak diketahui. Fungsi NetUserAdd dan fungsi NetUserSetInfo mengabaikan anggota ini.
Anggota ini dipertahankan secara terpisah pada setiap pengendali domain cadangan (BDC) di domain. Untuk mendapatkan nilai yang akurat, Anda harus mengkueri setiap BDC di domain. Logoff terakhir terjadi pada saat yang ditunjukkan oleh nilai terbesar yang diambil.
usri11_bad_pw_count
Jenis: DWORD
Berapa kali pengguna mencoba masuk ke akun ini menggunakan kata sandi yang salah. Nilai – 1 menunjukkan bahwa nilai tidak diketahui. Fungsi NetUserAdd dan NetUserSetInfo mengabaikan anggota ini.
Anggota ini direplikasi dari pengendali domain utama (PDC); ini juga dipertahankan pada setiap pengendali domain cadangan (BDC) di domain. Untuk mendapatkan nilai yang akurat, Anda harus mengkueri setiap BDC di domain. Frekuensi pengguna mencoba masuk menggunakan kata sandi yang salah adalah nilai terbesar yang diambil.
usri11_num_logons
Jenis: DWORD
Frekuensi pengguna berhasil masuk ke akun ini. Nilai – 1 menunjukkan bahwa nilai tidak diketahui. Panggilan ke fungsi NetUserAdd dan NetUserSetInfo mengabaikan anggota ini.
Anggota ini dipertahankan secara terpisah pada setiap pengendali domain cadangan (BDC) di domain. Untuk mendapatkan nilai yang akurat, Anda harus mengkueri setiap BDC di domain. Berapa kali pengguna berhasil masuk adalah jumlah nilai yang diambil.
usri11_logon_server
Jenis: LPWSTR
Penunjuk ke string Unicode yang berisi nama server tempat permintaan masuk dikirim. Nama server harus didahului dengan dua garis miring terbalik (\). Untuk menunjukkan bahwa permintaan masuk dapat ditangani oleh server masuk apa pun, tentukan tanda bintang (\*) untuk nama server. String NULL menunjukkan bahwa permintaan harus dikirim ke pengendali domain.
Untuk server Windows, NetUserGetInfo dan NetUserEnum mengembalikan \*. Fungsi NetUserAdd dan NetUserSetInfo mengabaikan anggota ini.
usri11_country_code
Jenis: DWORD
Kode negara/wilayah untuk bahasa pilihan pengguna.
usri11_workstations
Jenis: LPWSTR
Penunjuk ke string Unicode yang berisi nama stasiun kerja tempat pengguna dapat masuk. Sebanyak delapan stasiun kerja dapat ditentukan; nama harus dipisahkan dengan koma. String NULL menunjukkan bahwa tidak ada batasan. Untuk menonaktifkan masuk dari semua stasiun kerja ke akun ini, atur nilai UF_ACCOUNTDISABLE di anggota usri11_flags .
usri11_max_storage
Jenis: DWORD
Jumlah maksimum ruang disk yang dapat digunakan pengguna. Tentukan USER_MAXSTORAGE_UNLIMITED untuk menggunakan semua ruang disk yang tersedia.
usri11_units_per_week
Jenis: DWORD
Jumlah unit waktu dengan panjang yang sama di mana minggu dibagi. Nilai ini diperlukan untuk menghitung panjang string bit di anggota usri11_logon_hours .
Anggota ini harus UNITS_PER_WEEK untuk LAN Manager 2.0. Elemen ini diabaikan oleh fungsi NetUserAdd dan NetUserSetInfo .
Untuk aplikasi layanan, unit harus menjadi salah satu nilai berikut: SAM_DAYS_PER_WEEK, SAM_HOURS_PER_WEEK, atau SAM_MINUTES_PER_WEEK.
usri11_logon_hours
Jenis: PBYTE
Penunjuk ke string bit 21-byte (168 bit) yang menentukan waktu pengguna dapat masuk. Setiap bit mewakili jam unik dalam seminggu, dalam Greenwich Mean Time (GMT).
Bit pertama (bit 0, kata 0) adalah Hari Minggu, 0:00 hingga 0:59; bit kedua (bit 1, kata 0) adalah Minggu, 1:00 hingga 1:59; dan sebagainya. Perhatikan bahwa bit 0 di word 0 mewakili Hari Minggu dari pukul 0:00 hingga 0:59 hanya jika Anda berada di zona waktu GMT. Dalam semua kasus lain, Anda harus menyesuaikan bit sesuai dengan offset zona waktu Anda (misalnya, GMT dikurangi 8 jam untuk Waktu Standar Pasifik).
Tentukan penunjuk NULL di anggota ini saat memanggil fungsi NetUserAdd untuk menunjukkan tidak ada batasan waktu. Tentukan penunjuk NULL saat memanggil fungsi NetUserSetInfo untuk menunjukkan bahwa tidak ada perubahan yang harus dilakukan pada waktu di mana pengguna dapat masuk.
usri11_code_page
Jenis: DWORD
Halaman kode untuk bahasa pilihan pengguna.
Keterangan
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.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | lmaccess.h (termasuk Lm.h) |