GetEnvironmentStrings 函式 (processenv.h)

擷取目前進程的環境變數。

Syntax

LPCH GetEnvironmentStrings();

如果函式成功，則傳回值是目前進程環境區塊的指標。

如果函式失敗，則傳回值為 NULL。

GetEnvironmentStrings 函式會傳回記憶體區塊的指標，其中包含呼叫進程的環境變數， (系統和用戶環境變數) 。

每個環境區塊都包含下列格式的環境變數：

Var1=Value1\0
Var2=Value2\0
Var3=Value3\0
...
VarN=ValueN\0\0

環境變數的名稱不能包含等號 (=) 。

將此記憶體視為唯讀;請勿直接修改。若要新增或變更環境變數，請使用 GetEnvironmentVariable 和 SetEnvironmentVariable 函式。

當不再需要 GetEnvironmentStrings 傳回的區塊時，應該呼叫 FreeEnvironmentStrings 函式來釋放它。

請注意，此函式的 ANSI 版本 GetEnvironmentStringsA 會傳回 OEM 字元。

如需範例，請參閱變更環境變數。

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	processenv.h (包含 Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2)
程式庫	Kernel32.lib
DLL	Kernel32.dll