WritePrivateProfileString 写配置文件
BOOL WINAPI WritePrivateProfileString(
_In_ LPCTSTR lpAppName,
_In_ LPCTSTR lpKeyName,
_In_ LPCTSTR lpString,
_In_ LPCTSTR lpFileName
);
参数:
lpAppName:
要复制字符串的部分的名称。如果该部分不存在,则创建它。该部分的名称与大小写无关; 字符串可以是大写和小写字母的任意组合。
lpKeyName:
与字符串关联的键的名称。如果该键在指定的部分不存在,则创建它。如果此参数为NULL,则整个部分(包括该部分中的所有条目)将被删除。
lpString:
一个零结尾的字符串写入文件。如果此参数为NULL,则lpKeyName参数指向的键将被删除。
lpFileName:
初始化文件的名称。如果文件是使用Unicode字符创建的,则该函数将Unicode字符写入该文件。否则,函数写入ANSI字符。
返回值:
如果函数成功将字符串复制到初始化文件,则返回值不为零。如果函数失败,或者刷新最近访问的初始化文件的缓存版本,返回值为零。要获取扩展错误信息,请调用 GetLastError。
注意:
初始化文件中的一个部分必须具有以下形式:
[section]
key=string
.
.
.
如果lpFileName参数不包含文件的完整路径和文件名, WritePrivateProfileString会在Windows目录中搜索该文件。如果该文件不存在,则此功能将在Windows目录中创建该文件。
如果lpFileName包含完整路径和文件名,并且该文件不存在,则 WritePrivateProfileString将创建该文件。指定的目录必须已经存在。
GetPrivateProfileString 读取配置文件
DWORD WINAPI GetPrivateProfileString(
_In_ LPCTSTR lpAppName,
_In_ LPCTSTR lpKeyName,
_In_ LPCTSTR lpDefault,
_Out_ LPTSTR lpReturnedString,
_In_ DWORD nSize,
_In_ LPCTSTR lpFileName
);
参数:
lpAppName [in]
包含密钥名称的部分的名称。如果此参数为NULL,则 GetPrivateProfileString函数将文件中的所有段名复制到提供的缓冲区。
lpKeyName [in]
要检索其关联字符串的键的名称。如果此参数为NULL,则由lpAppName参数指定的部分中的所有键名将复制到由lpReturnedString参数指定的缓冲区中。
lpDefault [in]
默认字符串。如果在初始化文件中找不到lpKeyName键,则 GetPrivateProfileString将默认字符串复制到lpReturnedString缓冲区。如果此参数为NULL,则默认值为空字符串“”。
避免指定一个带有空白字符的默认字符串。该函数在lpReturnedString缓冲区中插入一个空字符以去除任何尾随的空白。
lpReturnedString [out]
指向接收检索字符串的缓冲区的指针。
nSize [in]
lpReturnedString参数指向的缓冲区的大小,以字符为单位。
lpFileName [in]
初始化文件的名称。如果此参数不包含文件的完整路径,系统将在Windows目录中搜索该文件。
返回值:
返回值是复制到缓冲区的字符数,不包括终止空字符。
如果lpAppName和lpKeyName都不为NULL,并且提供的目标缓冲区太小而不能容纳所请求的字符串,则该字符串将被截断,后跟一个空字符,返回值等于nSize减去一个。
如果lpAppName或lpKeyName为NULL,并且提供的目标缓冲区太小而不能容纳所有字符串,则最后一个字符串将被截断,后跟两个空字符。在这种情况下,返回值等于nSize减去2。
在没有找到由lpFileName指定的初始化文件或包含无效值的情况下,该函数将设置值为“0x2”(找不到文件)的errorno。要检索扩展错误信息,请调用GetLastError。
查看更多 WritePrivateProfileString
查看更多 GetPrivateProfileString