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 |