Fungsi ExpandEnvironmentStringsForUserW (userenv.h)
Memperluas string sumber dengan menggunakan blok lingkungan yang ditetapkan untuk pengguna yang ditentukan.
Sintaks
USERENVAPI BOOL ExpandEnvironmentStringsForUserW(
[in, optional] HANDLE hToken,
[in] LPCWSTR lpSrc,
[out] LPWSTR lpDest,
[in] DWORD dwSize
);
Parameter
[in, optional] hToken
Jenis: HANDEL
Token untuk pengguna, dikembalikan dari fungsi LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken, atau OpenThreadToken . Token harus memiliki akses TOKEN_IMPERSONATE dan TOKEN_QUERY. Selain itu, pada Windows 7 token juga harus memiliki akses TOKEN_DUPLICATE. Untuk informasi selengkapnya, lihat Hak Akses untuk Objek Access-Token.
Jika hTokenNULL, blok lingkungan hanya berisi variabel sistem.
[in] lpSrc
Jenis: LPCTSTR
Penunjuk ke string sumber yang dihentikan null untuk diperluas.
[out] lpDest
Jenis: LPTSTR
Penunjuk ke buffer yang menerima string yang diperluas.
[in] dwSize
Jenis: DWORD
Menentukan ukuran buffer lpDest , dalam TCHAR.
Nilai kembali
Jenis: BOOL
TRUE jika berhasil; jika tidak, FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Berikut ini adalah contoh string sumber:
%USERPROFILE%\ntuser.dat
Saat ExpandEnvironmentStringsForUser kembali, string tujuan diperluas sebagai berikut:
C:\Documents and Settings\UserName\ntuser.dat
Catatan
Header userenv.h mendefinisikan ExpandEnvironmentStringsForUser sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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] |
| Target Platform | Windows |
| Header | userenv.h |
| Pustaka | Userenv.lib |
| DLL | Userenv.dll |