共用方式為


GetEnvironmentStringsW 函式 (processenv.h)

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

語法

LPWCH GetEnvironmentStringsW();

傳回值

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

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

言論

GetEnvironmentStrings 函式會傳回記憶體區塊的指標,其中包含呼叫進程的環境變數(系統和用戶環境變數)。 每個環境區塊都包含下列格式的環境變數:

Var1=value1\0
Var2=Value2\0
Var3=value3\0
...
VarN=ValueN\0\0

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

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

當不再需要由 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

另請參閱

環境變數

FreeEnvironmentStrings

GetEnvironmentVariable

SetEnvironmentVariable