MFC中GetPrivateProfileString相关函数

项目中用到了这个函数，所以了解了一下，参考了一些博客：

http://blog.sina.com.cn/s/blog_a599b5960101tsbk.html

http://blog.csdn.net/artmcu/article/details/8077815（连着三篇）

http://www.cnblogs.com/rosesmall/archive/2012/09/12/2681897.html

自己又动手实现了一下，又发现#include<afx.h>只能在MFC工程中用到，修改属性--->常规---->MFC的使用----->选择（在共享 DLL 中使用 MFC），还有C/C++中-->代码生成--->运行库--->最后一个（/MDd）。

::WritePrivateProfileString( _T("Options"), _T("Name"), m_strName, pApp->m_szIni );
INI文件编程,WINAPI函数WritePrivateProfileString,GetPrivateProfileString 收藏
    在我们写的程序当中,总有一些配置信息需要保存下来,以便完成程序的功能,最简单的办法就是将这些信息写入INI文件中,程序初始化时再读入.具体应用如下:
　　一.将信息写入.INI文件中.
　　1.所用的WINAPI函数原型为:
BOOL WritePrivateProfileString(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
LPCTSTR lpString,
LPCTSTR lpFileName
);
　　其中各参数的意义:
　　　LPCTSTR lpAppName 是INI文件中的一个字段名.
　　　LPCTSTR lpKeyName 是lpAppName下的一个键名,通俗讲就是变量名.
　　　LPCTSTR lpString 是键值,也就是变量的值,不过必须为LPCTSTR型或CString型的.

LPCTSTR lpFileName 是完整的INI文件名.

2.具体使用方法:设现有一名学生,需把他的姓名和年龄写入 c:studstudent.ini 文件中.

CString strName,strTemp;
int nAge;
strName="张三";
nAge=12;
::WritePrivateProfileString("StudentInfo","Name",strName,"c:\stud\student.ini");

此时c:studstudent.ini文件中的内容如下:
[StudentInfo]

　　　Name=张三
　　3.要将学生的年龄保存下来,只需将整型的值变为字符型即可:
strTemp.Format("%d",nAge);
::WritePrivateProfileString("StudentInfo","Age",strTemp,"c:\stud\student.ini");

　　二.将信息从INI文件中读入程序中的变量.
　　1.所用的WINAPI函数原型为:
DWORD GetPrivateProfileString(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
LPCTSTR lpDefault,
LPTSTR lpReturnedString,
DWORD nSize,
LPCTSTR lpFileName
);
　　其中各参数的意义:
　　　前二个参数与 WritePrivateProfileString中的意义一样.

　　　lpDefault : 如果INI文件中没有前两个参数指定的字段名或键名,则将此值赋给变量.
　　　lpReturnedString : 接收INI文件中的值的CString对象,即目的缓存器.
　　　nSize : 目的缓存器的大小.
　　　lpFileName : 是完整的INI文件名.
　　2.具体使用方法:现要将上一步中写入的学生的信息读入程序中.
CString strStudName;
int nStudAge;
GetPrivateProfileString("StudentInfo","Name","默认姓名",strStudName.GetBuffer(MAX_PATH),MAX_PATH,"c:\stud\student.ini");

//MAX_PATH:是微软最大路径占的字节所设的宏

　　执行后 strStudName 的值为:"张三",若前两个参数有误,其值为:"默认姓名".

     在GetPrivateProfileString最后一个参数是配置文件路径的参数，此路径只能是绝对路径，不能是相对路径，但现在我需要是我的exe文件能和我的配置文件在一起。因此我使用了GetCurrentDirectory函数。

原代码如下：

CString server_ip;
CString des="";
::GetCurrentDirectory(MAX_PATHLENGTH,des.GetBuffer(MAX_PATHLENGTH));
des.ReleaseBuffer();
des+="\config.ini";
GetPrivateProfileString("PhoneDemo","Server_IP","",server_ip.GetBufferSetLength(15),15,des);
server_ip.ReleaseBuffer();

注意：在这里使用CString变量时，在使用完GetBuffer后，紧接着一定要使用ReleaseBuffer()函数，才可以进行其他的诸如字符串+操作

　　3.读入整型值要用另一个WINAPI函数:
UINT GetPrivateProfileInt(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
INT nDefault,
LPCTSTR lpFileName
);
　　这里的参数意义与上相同.使用方法如下:
nStudAge=GetPrivateProfileInt("StudentInfo","Age",10,"c:\stud\student.ini");

更多说明：
获取路径
GetCurrentDirectory只是返回当前进程的当前目录,而并不是进程的镜像文件(.exe)所在的目录
GetCurrentDirectory()适用于XP等系统,在WinCE上不能使用
GetModuleFileName()适用于WinCE2.0以后
使用方法:
//下面的一段代码主要是获得当前程序的运行目录(.exe)所在的目录
{
    CString path;
    GetModuleFileName(NULL,path.GetBufferSetLength(MAX_PATH+1),MAX_PATH);
    path.ReleaseBuffer();
    int pos = path.ReverseFind('\');
    path = path.Left(pos);
}
GetModuleFileName函数
WINAPI DWORD GetModuleFileName(
  HMODULE hModule,
  LPWSTR lpFilename,
  DWORD nSize
);
      GetBuffer和ReleaseBuffer是一套需要配合使用的函数, 与GetBufferSetLength相比, 优点是如果分配的空间大于实际保存的字符串(0结尾),
ReleaseBuffer会把多余申请的空间释放, 归还给系统; 但使用时需要注意以下问题: 如果要保存的字符串为abc(0结尾),则GetBuffer参数应至少
为3; 如果要保存的内容不是以0结尾, 比如是读取文件数据, 则GetBuffer参数如果大于文件长度时,ReleaseBuffer参数一定要为文件长度(如果
GetBuffer参数为文件长度的话不存在问题,ReleaseBuffer参数可以为默认-1)!
 GetBufferSetLength相对比较容易理解, 它申请一个指定长度的空间, 即使里面最终保存的字符串长度小于申请的空间长度, 也不会将多余空间释放.
__________________________________________________________________________________________________________________DWORD GetCurrentDirectory(
  DWORD nBufferLength,
  LPTSTR lpBuffer
);The GetCurrentDirectory function retrieves the current directory for the current process.GetCurrentDirectory返回当前进程的当前目录，并不一定返回你的应用程序的目录。如果你在应用程序中调用了打开文件对话框，你选择了一个文件，那么，这个文件所在的目录就成了当前进程的当前目录了。Parameters
nBufferLength: 接收保存路径的字符串缓存长度, 缓存必须有一个保存结束的空字符的位置.
lpBuffer:指向接收字符串的缓存,收到的非空字符串指定了当前目录的绝对路径.
DWORD GetModuleFileName(
  HMODULE hModule,
  LPTSTR lpFilename,
  DWORD nSize
);
GetModuleFileName 函数指定当前进程模块的路径.它仅仅操作当前进程下的模块.如果想获取其他进程下的模块信息, 则需使用 GetModuleFileNameEx 函数.Parameters
hModule:模块的句柄，或者设置为NULL表示当前模块。
lpFilename:保存路径的缓冲区。
nSize:缓冲区的大小。
例子: TCHAR strExePath[_MAX_PATH];
 GetModuleFileName(NULL,strExePath,_MAX_PATH); PathRemoveFileSpec(strExePath);如果当前执行程序的位置为c:	est.exe,GetModuleFileName获取的strExePath即为c:	est.ext,通过去掉名称函数最终获得的strExePath为c:。(注意PathRemoveFileSpec 系统API函数调用时必须包含#include  "Shlwapi.h"作为头文件) TCHAR strExePath[_MAX_PATH];
 GetCurrentDirectory(_MAX_PATH, strExePath); 获取当前的系统目录,可能是c:也可能是其他值。
 
------------------------------------------------------------------------------------------------------
shlwapi.dll
　　shlwapi - shlwapi.dll - DLL文件信息
　　DLL 文件： shlwapi 或者 shlwapi.dll
　　DLL 名称： Microsoft Shell Light-weight Utility Library
　　描述： 　　shlwapi.dll是UNC和URL地址动态链接库文件，用于注册键值和色彩设置。
　　属于： Microsoft Windows Shell
　　系统 DLL文件： 是
　　常见错误： File Not Found, Missing File, Exception Errors
　　安全等级 (0-5): 0 　　间谍软件： 否 　　广告软件： 否
VC中使用GetModuleFileName获取应用程序路径

.\与API函数GetModuleFileName获取应用程序目录有何不一样？
采用.\也能获得应用程序目录，采用GetModuleFileName也能获得，二者有何不同？
一样！
一个是相对路径，一个是绝对路径
.\是得到应用程序的当前目录，但当前目录不一定等于应用程序执行文件的所在目录，一个应用程序被启动时，当前目录是可以被任意设置的。
GetModuleFileName()得到模块的完整路径名，例如，你载入c:windowssystem32a.dll，得到模块句柄h，则你可以用GetModuleFileName()得到h模块的完整路径名。
.\一般用在包含头文件的语句中。
另一个是程序编译后起作用的，例如，打开自定义的配置文件等。
如何去取得这个Hanlde?
如果你直接用LoadLibrary()或AfxLoadLibrary()载入dll，该函数返回值就是handle；
如果你隐式载入dll, 用GetModuleHandle("dll文件名")也可以得到handle；
MFC程序得到本身路径
在开发工程中，往往需要知道当前程序本身所在目录。
一种方法是在程序安装的时候利用安装程序把文件路径写入注册表。在较大的程序中，这种方法比较常用
另一种，就是在程序得到路径。这样，程序随便移动到哪里，都可以得到正确的路径。这也是本文介绍的方法。
 
方法一：
[code]
//得到帮助文件的路径
CString strFullName = AfxGetApp()->m_pszHelpFilePath;
//得到的是：X:XXXXXXX.hlp
//解析路径，得到当前运行程序所在目录
char drive[_MAX_DRIVE];
char dir[_MAX_DIR];
_splitpath(strAppName, drive, dir, NULL,NULL);
CString strPath;
strPath.Format("%s%s", drive, dir);
//strPath即为得到的当前运行程序所在目录
[/code]
另外，AfxGetApp()->m_pszAppName 得到应用程序名称
AfxGetApp()->m_pszExeName 得到程序文件名，不包括扩展名
 
方法二：
得到全路径
TCHAR exeFullPath[MAX_PATH]; // MAX_PATH
GetModuleFileName(NULL,exeFullPath,MAX_PATH);//得到程序模块名称，全路径
也就是当前运行程序的全路径
利用方法一的解析路径的方法，即可得到程序所在路径。
GetModuleFileName函数原型
DWORD GetModuleFileName(
   HMODULE hModule,     // handle to module。将要得到的模块的句柄。如果是当前模块，NULL
   LPTSTR lpFilename,   // path buffer   得到的文件名。
   DWORD nSize)          // size of buffer   一般MAX_PATH就可以了

补充四点:

　　　1.INI文件的路径必须完整,文件名前面的各级目录必须存在,否则写入不成功,该函数返回 FALSE 值.

　　　2.文件名的路径中必须为 \ ,因为在VC++中, \ 才表示一个 .

　　　3.也可将INI文件放在程序所在目录,此时 lpFileName 参数为: ".\student.ini".

　　　4.从网页中粘贴源代码时,最好先粘贴至记事本中,再往VC中粘贴,否则易造成编译错误,开始时我也十分不解,好好的代码怎么就不对呢?后来才找到这个方法.还有一些代码中使用了全角字符如:＜，＼等,也会
造成编译错误.

INI文件编程

    INI 文件在系统配置及应用程序参数保存与设置方面，具有很重要的作用，所以可视化的编程一族，如VB、VC、VFP、Delphi等都提供了读写INI文件的方法，其中Delphi中操作INI文件，最为简洁，这是因为Delphi3提供了一个TInifile类，使我们可以非常灵活的处理INI文件。

一、有必要了解INI文件的结构：
;注释
[小节名]
关键字=值
...
　 INI文件允许有多个小节，每个小节又允许有多个关键字， "="后面是该关键字的值。
　 值的类型有三种：字符串、整型数值和布尔值。其中字符串存贮在INI文件中时没有引号，
布尔真值用1表示，布尔假值用0表示。
　 注释以分号";"开头。
二、定义
　 1、在Interface的Uses节增加IniFiles；
　 2、在Var变量定义部分增加一行：
myinifile:Tinifile;
　 然后，就可以对变量myinifile进行创建、打开、读取、写入等操作了。
    Delphi3提供了一个TInifile类下的操作：
三、打开INI文件
myinifile:=Tinifile.create('program.ini');
　  上面这一行语句将会为变量myinifile与具体的文件 program.ini建立联系，然后，就可以通过变量myinifile，来读写 program.ini文件中的关键字的值了。值得注意的是，如果括号中的文件名没有指明路径的话，那么这个Program.ini文件会存储在 Windows目录中,把Program.ini文件存储在应用程序当前目录中的方法是：为其指定完整的路径及文件名。下面的两条语句可以完成这个功能：

Filename:=ExtractFilePath(Paramstr(0))+'program.ini';

myinifile:=Tinifile.Create(filename);

四、读取关键字的值
　针对INI文件支持的字符串、整型数值、布尔值三种数据类型，TINIfiles类提供了三种不同的对象方法来读取INI文件中关键字的值。
　 假设已定义变量vs、vi、vb分别为string、 integer、boolean类型。  
vs:=myinifile.Readstring('小节名','关键字',缺省值);
vi:=myinifile.Readinteger('小节名','关键字',缺省值);
vb:=myinifile.Readbool('小节名','关键字',缺省值);

　 其中缺省值为该INI文件不存在该关键字时返回的缺省值。

五、写入INI文件
　 同样的，TInifile类也提供了三种不同的对象方法，向INI文件写入字符串、整型数及布尔类型的关键字。  
myinifile.writestring('小节名','关键字',变量或字符串值);
myinifile.writeinteger('小节名','关键字',变量或整型数值);
myinifile.writebool('小节名','关键字',变量或True或False);
　 当这个INI文件不存在时，上面的语句还会自动创建该INI文件。
六、删除关键字
　 除了可用写入方法增加一个关键字，Tinifile类还提供了一个删除关键字的对象方法：
myinifile.DeleteKey('小节名','关键字');

七、小节操作
　 增加一个小节可用写入的方法来完成，删除一个小节可用下面的对象方法：
   myinifile.EraseSection('小节名');
　 另外Tinifile类还提供了三种对象方法来对小节进行操作：
　 myinifile.readsection('小节名',TStrings变量);可将指定小节中的所有关键字名读取至一个字符串列表变量中；
　 myinifile.readsections(TStrings变量);可将INI文件中所有小节名读取至一个字符串列表变量中去。
　 myinifile.readsectionvalues('小节名',TStrings变量);可将INI文件中指定小节的所有行（包括关键字、=、值）读取至一个字符串列表变量中去。

八、释放
在适当的位置用下面的语句释放myinifile：
myinifile.distory;
九、一个实例
　  下面用一个简单的例子(如图)，演示了建立、读取、存贮INI文件的方法。myini.ini文件中包含有"程序参数"小节，和用户名称（字符串）、是否正式用户（布尔值）和已运行时间（整型值）三个关键字。程序在窗体建立读取这些数据，并在窗体释放时写myini.ini文件。