.ini文件编程（WritePrivateProfileString,GetPrivateProfileString 的使用）

左手的ㄟ右手 2023-06-25 04:58 8阅读 0赞

INI文件编程,WINAPI函数WritePrivateProfileString,GetPrivateProfileString

在我们写的程序当中,总有一些配置信息需要保存下来,以便完成程序的功能,最简单的办法就是将这些信息写入INI文件中,程序初始化时再读入.

### 读取：GetPrivateProfileString ###

函数原型：

DWORD GetPrivateProfileString(
      LPCTSTR lpAppName,
      LPCTSTR lpKeyName,
      LPCTSTR lpDefault,
      LPTSTR  lpReturnedString,
      DWORD   nSize,
      LPCTSTR lpFileName
    );

> 参数含义：　
> 
> 　　lpAppName 是INI文件中的一个字段名.  
> 　　　lpKeyName 是lpAppName下的一个键名,通俗讲就是变量名.
> 
> lpDefault : 如果INI文件中没有前两个参数指定的字段名或键名,则将此值赋给变量.  
> 　　　lpReturnedString : 接收INI文件中的值的CString对象,即目的缓存器.  
> 　　　nSize : 目的缓存器的大小.  
> 　　　lpFileName : 是完整的INI文件名.即路径
> 
> 返回值：
> 
> 返回值是复制到缓冲区的字符数，不包括终止的**空**字符。
> 
> 如果*lpAppName*或*lpKeyName都不*为**NULL**，并且提供的目标缓冲区太小而无法容纳请求的字符串，则该字符串将被截断并后跟一个**空**字符，并且返回值等于*nSize*减一。
> 
> 如果*lpAppName*或*lpKeyName*为**NULL**，并且提供的目标缓冲区太小而无法容纳所有字符串，则最后一个字符串将被截断，后跟两个**空**字符。在这种情况下，返回值等于*nSize*减2。
> 
> 如果找不到由*lpFileName*指定的初始化文件，或者该初始化文件包含无效值，则此函数会将**errorno**设置为值“ 0x2”（找不到文件）

例：读取study.ini文件study字段下hello\_world的值

![20191226111511274.png][]

CString strStudyPath = _T("d:\\study.ini");
    CFileStatus status;  
    
    if(!CFile::GetStatus(strStudyPath,status);    // 获取文件信息
            return FALSE;
    
    long lfilesize = status.m_size;   //文件大小
    
    TCHAR *pParam = new TCHAR[lfilesize ];  //缓冲区
    
    GetPrivateProfileString(_T("system",_T("hello_world"),_T(""),pParam,lfilesize,strStudyPath);
    
    CString strParam = pParam;   //获取的值

关于GetStatus可点击：[https://blog.csdn.net/alzzw/article/details/103710488][https_blog.csdn.net_alzzw_article_details_103710488]

### 写入：WritePrivateProfileString ###

函数原型：

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

> 参数：
> 
> 　　　LPCTSTR lpAppName 是INI文件中的一个字段名.  
> 　　　LPCTSTR lpKeyName 是lpAppName下的一个键名,通俗讲就是变量名.  
> 　　　LPCTSTR lpString 是键值,也就是变量的值,不过必须为LPCTSTR型或CString型的.  
> LPCTSTR lpFileName 是完整的INI文件名.
> 
> 返回值：
> 
> 如果函数成功将字符串复制到初始化文件，则返回值为非零。
> 
> 如果函数失败，或者刷新了最近访问的初始化文件的缓存版本，则返回值为零

[20191226111511274.png]: https://img-blog.csdnimg.cn/20191226111511274.png
[https_blog.csdn.net_alzzw_article_details_103710488]: https://blog.csdn.net/alzzw/article/details/103710488