GetEnvironmentStrings 関数 (processenv.h)

現在のプロセスの環境変数を取得します。

構文

LPCH GetEnvironmentStrings();

関数が成功した場合、戻り値は現在のプロセスの環境ブロックへのポインターです。

関数が失敗した場合は、返される値は NULL です。

GetEnvironmentStrings 関数は、呼び出し元プロセスの環境変数 (システム環境変数とユーザー環境変数の両方) を含むメモリブロックへのポインターを返します。

各環境ブロックには、次の形式の環境変数が含まれています。

Var1=値 1\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 の Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll