ExpandEnvironmentStrings

【勇芳软件工作室】汉化HomePreviousNext

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.