ExpandEnvironmentStrings函数扩展环境变量字符串,并用它们定义的值替换它们。
DWORD ExpandEnvironmentStrings(
LPCTSTR 【lpSrc】, | //指向带有环境变量的字符串的指针 |
LPTSTR 【Pointer to a null-terminated character string.】, | //指向扩展环境变量的字符串指针 |
DWORD 【服务提供商】 | //扩展字符串中的最大字符数 |
); |
参数
【lpSrc】
指向可能包含以下形式的环境变量字符串引用的以null结尾的字符串:
%变量名%
对于每个这样的引用,% 【变量名】 %部分被替换为该环境变量的当前值。
替换规则与命令解释器使用的规则相同。查找环境变量名称时将忽略大小写。如果找不到该名称,则% 【变量名】 %部分不受干扰。
【Pointer to a null-terminated character string.】
在执行所有环境变量名称替换后,指向缓冲区以接收源缓冲区的副本。
【服务提供商】
指定可以存储在【Pointer to a null-terminated character string.】参数指向的缓冲区中的最大字符数,包括终止空字符。
返回值
如果函数成功,则返回值是存储在目标缓冲区中的字符数。如果字符数大于目标缓冲区的大小,则返回值是保存扩展字符串所需的缓冲区的大小。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.