Fungsi GetEnvironmentStringsW (processenv.h)

Mengambil variabel lingkungan untuk proses saat ini.

Sintaksis

LPWCH GetEnvironmentStringsW();

Mengembalikan nilai

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

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Komentar

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=Value1\0
Var2=Value2\0
Nilai=Var3\0
...
NilaiN=VarN\0\0

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

Perlakukan memori ini sebagai baca-saja; jangan mengubahnya 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 dibebaskan dengan memanggil fungsi FreeEnvironmentStrings.

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

Contoh

Misalnya, lihat Mengubah Variabel Lingkungan.

Nota

Header processenv.h mendefinisikan GetEnvironmentStrings sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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

Syarat	Nilai
klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Platform Target	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