struktur USER_INFO_1 (lmaccess.h)

Artikel
08/24/2023

Struktur USER_INFO_1 berisi informasi tentang akun pengguna, termasuk nama akun, data kata sandi, tingkat hak istimewa, dan jalur ke direktori beranda pengguna.

Sintaks

typedef struct _USER_INFO_1 {
  LPWSTR usri1_name;
  LPWSTR usri1_password;
  DWORD  usri1_password_age;
  DWORD  usri1_priv;
  LPWSTR usri1_home_dir;
  LPWSTR usri1_comment;
  DWORD  usri1_flags;
  LPWSTR usri1_script_path;
} USER_INFO_1, *PUSER_INFO_1, *LPUSER_INFO_1;

Anggota

usri1_name

Jenis: LPWSTR

Penunjuk ke string Unicode yang menentukan nama akun pengguna. Untuk fungsi NetUserSetInfo , anggota ini diabaikan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

usri1_password

Jenis: LPWSTR

Penunjuk ke string Unicode yang menentukan kata sandi pengguna yang ditunjukkan oleh anggota usri1_name . Panjang tidak boleh melebihi byte PWLEN. Fungsi NetUserEnum dan NetUserGetInfo mengembalikan penunjuk NULL untuk menjaga keamanan kata sandi.

Menurut konvensi, panjang kata sandi terbatas pada LM20_PWLEN karakter.

usri1_password_age

Jenis: DWORD

Jumlah detik yang telah berlalu sejak anggota usri1_password terakhir diubah. Fungsi NetUserAdd dan NetUserSetInfo mengabaikan anggota ini.

usri1_priv

Jenis: DWORD

Tingkat hak istimewa yang ditetapkan untuk anggota usri1_name . Saat Anda memanggil fungsi NetUserAdd , anggota ini harus USER_PRIV_USER. Saat Anda memanggil fungsi NetUserSetInfo , anggota ini harus menjadi nilai yang dikembalikan oleh 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
USER_PRIV_GUEST	Tamu
USER_PRIV_USER	Pengguna
USER_PRIV_ADMIN	Administrator

usri1_home_dir

Jenis: LPWSTR

Penunjuk ke string Unicode yang menentukan jalur direktori beranda untuk pengguna yang ditentukan dalam anggota usri1_name . String dapat berupa NULL.

usri1_comment

Jenis: LPWSTR

Penunjuk ke string Unicode yang berisi komentar untuk dikaitkan dengan akun pengguna. String ini dapat berupa string NULL , atau dapat memiliki sejumlah karakter sebelum mengakhiri karakter null.

usri1_flags

Jenis: DWORD

Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Perhatikan bahwa mengatur bendera kontrol akun pengguna mungkin memerlukan hak istimewa tertentu dan mengontrol hak akses. Untuk informasi selengkapnya, lihat bagian Keterangan dari fungsi NetUserSetInfo .

Nilai	Makna
UF_SCRIPT	Skrip masuk dijalankan. Nilai ini harus diatur.
UF_ACCOUNTDISABLE	Akun pengguna dinonaktifkan.
UF_HOMEDIR_REQUIRED	Direktori beranda diperlukan. Nilai ini diabaikan.
UF_PASSWD_NOTREQD	Tidak diperlukan kata sandi.
UF_PASSWD_CANT_CHANGE	Pengguna tidak dapat mengubah kata sandi.
UF_LOCKOUT	Akun saat ini dikunci. Anda dapat memanggil fungsi NetUserSetInfo dan menghapus nilai ini untuk membuka kunci akun yang dikunci sebelumnya. Anda tidak dapat menggunakan nilai ini untuk mengunci akun yang sebelumnya tidak terkunci.
UF_DONT_EXPIRE_PASSWD	Kata sandi tidak boleh kedaluwarsa di akun.
UF_ENCRYPTED_TEXT_PASSWORD_ALLOWED	Kata sandi pengguna disimpan di bawah enkripsi yang dapat dibalik di Direktori Aktif.
UF_NOT_DELEGATED	Menandai akun sebagai "sensitif"; pengguna lain tidak dapat bertindak sebagai delegasi akun pengguna ini.
UF_SMARTCARD_REQUIRED	Mengharuskan pengguna untuk masuk ke akun pengguna dengan kartu pintar.
UF_USE_DES_KEY_ONLY	Batasi prinsipal ini untuk hanya menggunakan jenis enkripsi Standar Enkripsi Data (DES) untuk kunci.
UF_DONT_REQUIRE_PREAUTH	Akun ini tidak memerlukan praauthentikasi Kerberos untuk masuk.
UF_TRUSTED_FOR_DELEGATION	Akun diaktifkan untuk delegasi. Ini adalah pengaturan sensitif keamanan; akun dengan opsi ini diaktifkan harus dikontrol dengan ketat. Pengaturan ini memungkinkan layanan yang berjalan di bawah akun untuk mengasumsikan identitas klien dan mengautentikasi sebagai pengguna tersebut ke server jarak jauh lain di jaringan.
UF_PASSWORD_EXPIRED	Kata sandi pengguna telah kedaluwarsa. Windows 2000: Nilai ini tidak didukung.
UF_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION	Akun dipercaya untuk mengautentikasi pengguna di luar paket keamanan Kerberos dan mendelegasikan pengguna tersebut melalui delegasi yang dibatasi. Ini adalah pengaturan sensitif keamanan; akun dengan opsi ini diaktifkan harus dikontrol dengan ketat. Pengaturan ini memungkinkan layanan yang berjalan di bawah akun untuk menegaskan identitas klien dan mengautentikasi sebagai pengguna tersebut untuk mengonfigurasi layanan secara khusus di jaringan. Windows 2000: Nilai ini tidak didukung.

Nilai berikut menjelaskan jenis akun. Hanya satu nilai yang dapat diatur. Anda tidak dapat mengubah jenis akun menggunakan fungsi NetUserSetInfo .

Nilai	Makna
UF_NORMAL_ACCOUNT	Ini adalah jenis akun default yang mewakili pengguna biasa.
UF_TEMP_DUPLICATE_ACCOUNT	Ini adalah akun untuk pengguna yang akun utamanya berada di domain lain. Akun ini menyediakan akses pengguna ke domain ini, tetapi tidak ke domain mana pun yang mempercayai domain ini. Manajer Pengguna mengacu pada jenis akun ini sebagai akun pengguna lokal.
UF_WORKSTATION_TRUST_ACCOUNT	Ini adalah akun komputer untuk komputer yang merupakan anggota domain ini.
UF_SERVER_TRUST_ACCOUNT	Ini adalah akun komputer untuk pengendali domain cadangan yang merupakan anggota domain ini.
UF_INTERDOMAIN_TRUST_ACCOUNT	Ini adalah izin untuk mempercayai akun untuk domain yang mempercayai domain lain.

usri1_script_path

Jenis: LPWSTR

Penunjuk ke string Unicode yang menentukan jalur untuk file skrip masuk pengguna. File skrip dapat berupa . File CMD, file .EXE, atau file .BAT. String juga bisa NULL.

Keterangan

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


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)