（1）WritePrivateProfileString函数的功能简介：WritePrivateProfileString函数用于将指定的字符串信息写入指定的ini文件。

（2）WritePrivateProfileString函数的语法及其参数：WritePrivateProfileString( lpApplicationName, lpKeyName, lpString, lpFileName )，参数如下：

lpApplicationName：必需参数，指向要写入私有配置文件的应用程序名字符串；

lpKeyName：必需参数，指向要写入的键名称字符串；

lpString：必需参数，指向要写入的字符串；

lpFileName：必需参数，指向要写入的私有配置文件文件名。

（3）WritePrivateProfileString函数实现的功能：WritePrivateProfileString函数用于将指定的键名、字符串写入指定的ini文件，用于存储用户私有的配置信息。它采用key-value形式，即：key=value，其中key是某项配置信息的名称，而value则是配置信息的数值；如果指定的项存在则更新，否则则在指定的配置文件中新添加一个项。

（4）WritePrivateProfileString函数的具体用法：

（a）WritePrivateProfileString(\"APP\",\"key1\",\"value\", \"FileName.ini\");

该示例的意思是将字符串value写入键名为key1的项中，APP为主段落，并把该键－值写入FileName.ini文件中。

（b）WritePrivateProfileString(\"APP\",\"key1\",NULL, \"FileName.ini\");

该示例的意思是从指定的FileName.ini文件中的APP的主段落删除key1的项。

（c）WritePrivateProfileString(\"APP\",\"key1\",\"value\", \"FileName.ini\");

该示例的意思是将字符串value写入指定的FileName.ini文件中的APP主段落的key1键，如果该键不存在，则新建一个键－值。

（d）WritePrivateProfileString(\"APP\",\"key1\",\"value\", \"FileName.ini\");

该示例的意思是将字符串value写入指定的FileName.ini文件中的APP主段落的key1键，如果该键存在，则替换旧值为新值。

1、writeprivateprofilestring函数：writeprivateprofilestring函数是Windows中定义的API接口，用于向操作系统的私有配置文件（如win.ini、system.ini和*.ini）中写入程序设置，以便在系统再次运行时能够保存设置或加载设置。

2、writeprivateprofilestring函数的原型：

BOOL WritePrivateProfileString(LPCTSTR lpAppName,LPCTSTR lpKeyName,LPCTSTR lpString,LPCTSTR lpFileName);

3、参数解释：

（1）lpAppName：[in] 指向欲让WritePrivateProfileString函数修改的程序节的指针，它必须是一个以NULL结尾的字符串，此字符串可由任何字符序列组成。

（2）lpKeyName：[in] 指向欲更改的项的指针，它必须指向一个以NULL结尾的字符串，此字符串可由任何字符序列组成。

（3）lpString：[in] 指向欲写入指定程序节和项中的字符串的指针，对接收数字，应把此值转换为字符串格式。

（4）lpFileName：[in] 指向定义程序节点和项所在INI文件的指针，它必须是一个以NULL结尾的字符串，此字符串可由任何字符序列组成。

4、返回值：

如果成功，返回值为非0；如果失败，返回值为0，以及具体的GetLastError函数调用可以得到失败原因。

5、writeprivateprofilestring函数的用法：

（1）如果要在适当的私有配置文件（如win.ini、system.ini和*.ini）中添加一个名为“Example”的程序节，可以使用writeprivateprofilestring函数声明如下所示：

WritePrivateProfileString(\"Example\", NULL, NULL, \"test.ini\");

（2）如果要添加在上一步中添加的程序节之下的一个键值“KeyName”，可以使用 writeprivateprofilestring函数声明如下所示：

WritePrivateProfileString(\"Example\", \"KeyName\", \"Value\", \"test.ini\");。

（3）如果要从私有配置文件中读取上一步中添加的“Value”键值，则可以从私有配置文件中读取出字符串，采用writeprivateprofilestring函数声明如下所示：

GetPrivateProfileString(\"Example\", \"KeyName\", \"DefaultValue\",\"test.ini\", buffer, len, \"test.ini\");。

（4）如果要修改上一步中添加的“Value”键值，则可以对其使用writeprivateprofilestring函数进行更新，声明如下所示：

WritePrivateProfileString(\"Example\", \"KeyName\", \"NewValue\", \"test.ini\");

（5）如果要从私有配置文件中删除上一步中添加的“Value”键值，则可以采用writeprivateprofilestring函数来实现，声明如下所示：

WritePrivateProfileString(\"Example\", \"KeyName\", NULL, \"test.ini\");。

6、结论：

writeprivateprofilestring函数是Windows中定义的API接口，该函数可以对操作系统的私有配置文件（如win.ini、system.ini和*.ini）中的程序设置进行修改、添加和删除，用来实现在程序运行时保存或读取设置项。