Fungsi SetEnvironmentVariable (winbase.h)
Mengatur konten variabel lingkungan yang ditentukan untuk proses saat ini.
Sintaks
BOOL SetEnvironmentVariable(
[in] LPCTSTR lpName,
[in, optional] LPCTSTR lpValue
);
Parameter
[in] lpName
Nama variabel lingkungan. Sistem operasi membuat variabel lingkungan jika tidak ada dan lpValue bukan NULL.
[in, optional] lpValue
Isi variabel lingkungan. Ukuran maksimum variabel lingkungan yang ditentukan pengguna adalah 32.767 karakter. Untuk informasi selengkapnya, lihat Variabel Lingkungan.
Windows Server 2003 dan Windows XP: Ukuran total blok lingkungan untuk proses mungkin tidak melebihi 32.767 karakter.
Jika parameter ini NULL, variabel dihapus dari lingkungan proses saat ini.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi ini tidak berpengaruh pada variabel lingkungan sistem atau variabel lingkungan dari proses lain.
Contoh
Misalnya, lihat Mengubah Variabel Lingkungan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | winbase.h (termasuk Windows.h pada Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |