Struktur PROFILEINFOW (profinfo.h)
Berisi informasi yang digunakan saat memuat atau membongkar profil pengguna.
Sintaks
typedef struct _PROFILEINFOW {
DWORD dwSize;
DWORD dwFlags;
MIDL_STRING LPWSTR lpUserName;
MIDL_STRING LPWSTR lpProfilePath;
MIDL_STRING LPWSTR lpDefaultPath;
MIDL_STRING LPWSTR lpServerName;
MIDL_STRING LPWSTR lpPolicyPath;
#if ...
ULONG_PTR hProfile;
#else
HANDLE hProfile;
#endif
} PROFILEINFOW, *LPPROFILEINFOW;
Anggota
dwSize
Jenis: DWORD
Ukuran struktur ini, dalam byte.
dwFlags
Jenis: DWORD
Anggota ini bisa menjadi salah satu bendera berikut:
PI_NOUI
Mencegah tampilan pesan kesalahan profil.
PI_APPLYPOLICY
Tidak didukung.
lpUserName
Jenis: LPTSTR
Penunjuk ke nama pengguna. Anggota ini digunakan sebagai nama dasar direktori untuk menyimpan profil baru.
lpProfilePath
Jenis: LPTSTR
Penunjuk ke jalur profil pengguna roaming . Jika pengguna tidak memiliki profil roaming, anggota ini bisa null. Untuk mengambil jalur profil roaming pengguna, panggil fungsi NetUserGetInfo , yang menentukan tingkat informasi 3 atau 4. Untuk informasi selengkapnya, lihat Keterangan.
lpDefaultPath
Jenis: LPTSTR
Penunjuk ke jalur profil pengguna default. Anggota ini bisa NULL.
lpServerName
Jenis: LPTSTR
Penunjuk ke nama pengontrol domain validasi, dalam format NetBIOS.
lpPolicyPath
Jenis: LPTSTR
Tidak digunakan, atur ke NULL.
hProfile
Jenis: HANDEL
Handel ke subtree registri HKEY_CURRENT_USER . Untuk informasi selengkapnya, lihat Keterangan.
Keterangan
Jangan gunakan variabel lingkungan saat menentukan jalur. Fungsi LoadUserProfile tidak memperluas variabel lingkungan, seperti %username%, di jalur.
Ketika panggilan LoadUserProfile berhasil dikembalikan, anggota hProfile menerima handel kunci registri yang dibuka ke akar subtree pengguna, dibuka dengan akses penuh (KEY_ALL_ACCESS). Untuk informasi selengkapnya, lihat bagian Keterangan di LoadUserProfile, Keamanan Kunci Registri dan Hak Akses, dan Hives Registri.
Layanan dan aplikasi yang memanggil LoadUserProfile harus memeriksa untuk melihat apakah pengguna memiliki profil roaming. Jika pengguna memiliki profil roaming, tentukan jalurnya sebagai anggota lpProfilePath dari struktur ini.
Catatan
Header profinfo.h mendefinisikan PROFILEINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | profinfo.h (termasuk Userenv.h) |