Fungsi GetEnvironmentStrings (processenv.h)

Mengambil variabel lingkungan untuk proses saat ini.

Sintaks

LPCH GetEnvironmentStrings();

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke blok lingkungan dari proses saat ini.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Fungsi GetEnvironmentStrings mengembalikan pointer ke blok memori yang berisi variabel lingkungan dari proses panggilan (baik sistem maupun variabel lingkungan pengguna).

Setiap blok lingkungan berisi variabel lingkungan dalam format berikut:

Var1=Nilai1\0
Var2=Nilai2\0
Var3=Nilai3\0
...
VarN=ValueN\0\0

Nama variabel lingkungan tidak dapat menyertakan tanda sama dengan (=).

Perlakukan memori ini sebagai baca-saja; jangan memodifikasinya secara langsung. Untuk menambahkan atau mengubah variabel lingkungan, gunakan fungsi GetEnvironmentVariable dan SetEnvironmentVariable .

Ketika blok yang dikembalikan oleh GetEnvironmentStrings tidak lagi diperlukan, blok tersebut harus dikosongkan dengan memanggil fungsi FreeEnvironmentStrings .

Perhatikan bahwa versi ANSI dari fungsi ini, GetEnvironmentStringsA, mengembalikan karakter OEM.

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	processenv.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

FreeEnvironmentStrings

GetEnvironmentVariable

SetEnvironmentVariable