На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

ExpandEnvironmentStrings



The ExpandEnvironmentStrings function expands environment-variable strings and replaces them with their defined values.

DWORD ExpandEnvironmentStrings(

LPCTSTR lpSrc, // pointer to string with environment variables
LPTSTR lpDst, // pointer to string with expanded environment variables
DWORD nSize // maximum characters in expanded string
);


Parameters

lpSrc

Points to a null-terminated string that might contain references to environment-variable strings of the form:

%variableName%


For each such reference, the %variableName% portion is replaced with the current value of that environment variable.
The replacement rules are the same as those used by the command interpreter. Case is ignored when looking up the environment-variable name. If the name is not found, the %variableName% portion is left undisturbed.

lpDst

Points to a buffer to receive a copy of the source buffer, after all environment-variable name substitutions have been performed.

nSize

Specifies the maximum number of characters that can be stored in the buffer pointed to by the lpDst parameter, including the terminating null character.



Return Values

If the function succeeds, the return value is the number of characters stored in the destination buffer. If the number of characters is greater than the size of the destination buffer, the return value is the size of the buffer required to hold the expanded strings.
If the function fails, the return value is zero. To get extended error information, call GetLastError.


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

ExpandEnvironmentStrings



Функция ExpandEnvironmentStrings расширяет среда-переменные строки и заменяет ими их определенными величинами.

DWORD ExpandEnvironmentStrings(

LPCTSTR lpSrc, // УКАЗАТЕЛЬ, чтобы нанизываться с переменными среды LPTSTR lpDst, // указателя, чтобы нанизываться с расширенными переменными максимальных символов среды DWORD nSize // в расширенной строке
);


Параметры

lpSrc

Точки на недействительный расторгнутую строку, которые могли содержать ссылки на среда-переменные строки формы:

%variableName%


Для каждой такой ссылки, %variableName% часть заменена текущей величиной этой переменной среды.
Правила замены такие же как и те использованные командным переводчиком. Случай игнорируется при рассмотрении по среда-переменном имени. Если имя не обнаружено, %variableName% часть оставлена неразрушенным.

lpDst

Точки на буфер, чтобы получать копию исходного буфера, в конце концов среда-переменная подстановка имени выполнена.

nSize

Определяет максимальное количество символов, которые могут быть сохранены в буфере указанном, чтобы параметром lpDst, включая завершающий недействительный символ.



Обратные Величины

Если функция добивается успеха, обратная величина является количеством символов сохраненных в буфере расположения. Если количество символов больше, чем размер буфера расположения, обратная величина является размером буфера требовавшегося, чтобы держать расширенные строки.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz