共用方式為


GetEnvironmentStrings 函式 (processenv.h)

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

Syntax

LPCH GetEnvironmentStrings();

傳回值

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

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

備註

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

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

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

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

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

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

另請參閱

環境變數

FreeEnvironmentStrings

GetEnvironmentVariable

SetEnvironmentVariable