struktur USER_INFO_23 (lmaccess.h)

Artikel
03/09/2023

Struktur USER_INFO_23 berisi informasi tentang akun pengguna, termasuk nama akun, nama lengkap pengguna, komentar yang terkait dengan akun, dan pengidentifikasi keamanan pengguna (SID).

Catatan

Struktur USER_INFO_23 menggantikan struktur USER_INFO_20 . Disarankan agar aplikasi menggunakan struktur USER_INFO_23 alih-alih struktur USER_INFO_20 .

Sintaks

typedef struct _USER_INFO_23 {
  LPWSTR usri23_name;
  LPWSTR usri23_full_name;
  LPWSTR usri23_comment;
  DWORD  usri23_flags;
  PSID   usri23_user_sid;
} USER_INFO_23, *PUSER_INFO_23, *LPUSER_INFO_23;

Anggota

usri23_name

Jenis: LPWSTR

Penunjuk ke string Unicode yang menentukan nama akun pengguna. Panggilan ke fungsi NetUserSetInfo mengabaikan anggota ini.

usri23_full_name

Jenis: LPWSTR

Penunjuk ke string Unicode yang berisi nama lengkap pengguna. String ini bisa berupa string null, atau dapat memiliki sejumlah karakter sebelum mengakhiri karakter null.

usri23_comment

Jenis: LPWSTR

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

usri23_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 untuk menghapus nilai ini dan 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 XP/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.

usri23_user_sid

Jenis: PSID

Penunjuk ke struktur SID yang berisi pengidentifikasi keamanan (SID) yang mengidentifikasi pengguna secara unik. Fungsi NetUserAdd dan NetUserSetInfo mengabaikan anggota ini.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	lmaccess.h (termasuk Lm.h)