ExpandEnvironmentStringsW

環境変数文字列を展開し、現在のユーザーに対して定義された値に置き換える。(Unicode)

ExpandEnvironmentStringsW lpSrc, lpDst, nSize

lpSrc : [wstr] %variableName% の形式で 1 つ以上の環境変数文字列を含むバッファ。そのような参照ごとに、%variableName% の部分はその環境変数の現在の値で置き換えられる。
lpDst : [wstr] lpSrc バッファ内の環境変数文字列の展開結果を受け取るバッファへのポインタ。このバッファは lpSrc バッファと同じであってはならないことに注意。
nSize : [int] lpDst パラメータが指すバッファに格納できる最大文字数。ANSI 文字列を使用する場合、バッファサイズは文字列長 + 終端 NULL 文字 + 1 でなければならない。Unicode 文字列を使用する場合、バッファサイズは文字列長 + 終端 NULL 文字でなければならない。

(プラグイン / モジュール : kernel32.dll)

解説

環境変数文字列を展開し、現在のユーザーに対して定義された値に置き換える。(Unicode)

[戻り値]
関数が成功した場合、戻り値は終端 NULL 文字を含む宛先バッファに格納された TCHAR
数である。宛先バッファが展開された文字列を保持するには小さすぎる場合、戻り値は必要なバッファサイズ（文字数）である。関数が失敗した場合、戻り値は
0 となる。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
lpSrc と lpDst バッファのサイズは 32K
に制限される。完全修飾パス内のフォルダ名を関連付けられた環境変数文字列に置き換えるには、PathUnExpandEnvStrings
関数を使用する。プロセスの環境変数のリストを取得するには、GetEnvironmentStrings 関数を使用する。

情報