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 |