ExpandEnvironmentStrings 関数を C++ のネイティブで使用する方法は?

2年 ago
海斗, 葵
1 minute

C++のExpandEnvironmentStrings関数を使用すると、環境文字列を展開し、環境変数が含まれた文字列を実際の環境変数値に置き換えることができます。

ExpandEnvironmentStrings 関数を使用するには、Windows.h ヘッダー ファイルを含み、次のように関数を呼び出す必要があります:

DWORD ExpandEnvironmentStrings(
  LPCWSTR lpSrc,    // 要扩展的字符串
  LPWSTR  lpDst,    // 存放结果的缓冲区
  DWORD   nSize     // 缓冲区大小
);

拡張する文字列を指定する lpSrc、結果を格納するバッファ lpDst、バッファのサイズを指定する nSize パラメータ

関数が展開後の文字列の長さを返します。ただし、関数の呼び出しが失敗した場合や、バッファが十分に大きくない場合は、返される文字列の長さは末尾の空文字を含みません。

例としてExpandEnvironmentStrings関数の使用方法を示します。

#include <Windows.h>
#include <iostream>

int main() {
    wchar_t lpSrc[] = L"%USERPROFILE%\\Documents";
    wchar_t lpDst[MAX_PATH];

    DWORD result = ExpandEnvironmentStrings(lpSrc, lpDst, MAX_PATH);
    if (result == 0) {
        std::cerr << "Failed to expand environment strings: " << GetLastError() << std::endl;
        return 1;
    }

    std::wcout << "Expanded string: " << lpDst << std::endl;
    return 0;
}

挙げた例のなかに、「%USERPROFILE%\Documents」という展開対象の文字列をlpDstバッファーに格納して、ExpandEnvironmentStrings 関数を使って展開したのち、展開した文字列を出力しています。

バッファが拡張後の文字列を収容するのに十分な大きさであることを確認してください。そうでない場合、切断や他の問題が発生する可能性があります。例ではバッファのサイズとして MAX_PATH を使用していますが、これは Windows.h で定義された定数で最大のパス長を表します。

bannerAds