GetEnvironmentStringsW 函式 (processenv.h)
擷取目前進程的環境變數。
語法
LPWCH GetEnvironmentStringsW();
傳回值
如果函式成功,傳回值就是目前進程環境區塊的指標。
如果函式失敗,傳回值為NULL。
言論
GetEnvironmentStrings 函式會傳回記憶體區塊的指標,其中包含呼叫進程的環境變數(系統和用戶環境變數)。 每個環境區塊都包含下列格式的環境變數:
Var1=value1\0
Var2=Value2\0
Var3=value3\0
...
VarN=ValueN\0\0
環境變數的名稱不能包含等號 (=)。
將此記憶體視為唯讀;請勿直接修改。 若要新增或變更環境變數,請使用 GetEnvironmentVariable 和 SetEnvironmentVariable 函式。
當不再需要由 GetEnvironmentStrings 傳回的區塊時,應該藉由呼叫 freeEnvironmentStrings 函式來釋放它。
請注意,此函式的 ANSI 版本 GetEnvironmentStringsA會傳回 OEM 字元。
例子
如需範例,請參閱 變更環境變數。
注意
processenv.h 標頭會根據 UNICODE 預處理器常數的定義,將 GetEnvironmentStrings 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
支援的最低伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平臺 | 窗戶 |
標頭 | processenv.h (包括 Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2 上的 Windows.h) |
連結庫 | Kernel32.lib |
DLL | Kernel32.dll |