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

Lihat juga

Variabel Lingkungan

GetEnvironmentVariable