Функция ExpandEnvironmentStrings преобразует строку с переменной окружения в строку со значением этой переменной.
DWORD ExpandEnvironmentStrings(
LPCTSTR lpSrc, // адрес строки с переменной окружения
LPTSTR lpDst, // адрес для строки с преобразованной переменной окружения
DWORD nSize // максимальный размер возвращаемой (преобразованной) строки
);
Параметры:
lpSrc |
Адрес нульзаканчивающейся строки, которая может содержать одну или несколько переменных окружения в такой форме:
%variableName%
Для каждой переменной окружения, часть %variableName% заменяется на текущее значение этой переменной.
Правила замены такие же, как и те, которые используются в командном интерпритаторе. Если имя переменной окружения не найдены, то часть %variableName% остается неизмененной. |
lpDst |
Адрес буфера преобразованного имени переменной окружения. |
nSize |
Указывает максимальное число символов, которые могут быть сохранены в буфере lpDst, учытывая заканчивающий строку нулевой символ. |
Возвращаемые значения:
В случае успеха возвращается количество символов, записанных в буфер-назначение. Если количество символов больше, чем размер буфера-назначения, возвращаемое значение – это требуемый размер буфера для сохранения преобразованных строк.
При неудаче, функция возвращает ноль. Для получения дополнительной информации об ошибке, вызовите GetLastError.
|