Fungsi ExpandEnvironmentStringsForUserA (userenv.h)

Memperluas string sumber dengan menggunakan blok lingkungan yang ditetapkan untuk pengguna yang ditentukan.

Sintaks

USERENVAPI BOOL ExpandEnvironmentStringsForUserA(
  [in, optional] HANDLE hToken,
  [in]           LPCSTR lpSrc,
  [out]          LPSTR  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

Lihat juga

Gambaran Umum Profil Pengguna

Referensi Profil Pengguna