操作INI檔案的函式主要有：

INI檔案可用來儲存，共享應用程式中少量的資料，其格式一般為：

[塊名1]
鍵名=值
...
[塊名n]
鍵名=值

一般一個INI檔案可有N個塊，第塊可有n個鍵名及值對應。每個鍵名及其值佔一行。
一般鍵的名稱可任取，不過建議用有意義的字元及詞構成。值一般可為整數和字串，其它型別要進行轉換。

GetProfileInt - 從 Win.ini 檔案的某個 Section 取得一個 key 的整數值，它的原形是：

GetProfileInt(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字串地址
INT nDefault // 如果 Key 值沒有找到，則返回預設的值是多少
);

如果 Key 值沒有找到的話，返回值是 nDefault 指定的預設值，如果 Key 中的值是負數，則返回 0，如果 Key 指定的是數字和字串的混合，則返回數字部分的值，比如說 x=1234abcd，則返回 1234

GetProfileString - 從 Win.ini 檔案的某個 Section 取得一個 key 的字串，它的原形是：

GetProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字串地址
LPCTSTR lpDefault, // 如果 Key 值沒有找到，則返回預設的字串的地址
LPTSTR lpReturnedString, // 返回字串的緩衝區地址
DWORD nSize // 緩衝區的長度
);

返回的字串在緩衝區內，返回的 eax 值是返回的字串的長度（不包括尾部的0）

GetProfileSection - 從 Win.ini 檔案中讀出整個 Section 的內容，它的原形是：

GetProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字串地址
LPTSTR lpReturnedString, // 返回資料的緩衝區地址
DWORD nSize // 返回資料的緩衝區長度
);

WriteProfileSection - 將一個整個 Section 的值 寫入 Win.ini 檔案的指定 Section 中，它的原形是：

WriteProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字串地址
LPCTSTR lpString // 要寫入的資料的地址
);

如果 Win.ini 沒有指定的 Section，API 會新建立一個並寫入資料，如果已經存在，則先刪除原來 Seciton 中所有的 Key 值然後寫入新的。

WriteProfileString - 將一個 Key 值寫入 Win.ini 檔案的指定 Section 中，它的原形是：

WriteProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字串地址
LPCTSTR lpString // 要寫的字串地址
);

如果 Win.ini 沒有指定的 Section，API 會新建 Section，如果沒有指定的 Key 則新建一個 Key 並寫入資料，如果已經存在，則用字串代替原來的值。 
以上的 Api 是對 Win.ini 操作的，當然對於我們來說，用的更多的是在程式執行的目錄中建立自己的 ini 檔案，如果需要對自己的 ini 檔案操作，就要用到另一組 Api，這一組 api 和上面的很象，只要把上面一組的 Profile 換成 PrivateProfile（私有的）就可以了，引數中也相應的多了一個 ini 檔名的引數。例如 GetPrivateProfileInt、GetPrivateProfileSection、WritePrivateProfileString 等等， 下面分別介紹：

GetPrivateProfileInt - 從 ini 檔案的某個 Section 取得一個 key 的整數值，它的原形是：

GetPrivateProfileInt(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字串地址
INT nDefault // 如果 Key 值沒有找到，則返回預設的值是多少
LPCTSTR lpFileName // ini 檔案的檔名
);

中間引數和返回值的定義和 GetProfileInt 是一樣的。

GetPrivateProfileString - 從 ini 檔案的某個 Section 取得一個 key 的字串，它的原形是：

GetPrivateProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字串地址
LPCTSTR lpDefault, // 如果 Key 值沒有找到，則返回預設的字串的地址
LPTSTR lpReturnedString, // 返回字串的緩衝區地址
DWORD nSize // 緩衝區的長度
LPCTSTR lpFileName // ini 檔案的檔名
);

GetPrivateProfileSection - 從 ini 檔案中讀出整個 Section 的內容，它的原形是：

GetPrivateProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字串地址
LPTSTR lpReturnedString, // 返回資料的緩衝區地址
DWORD nSize // 返回資料的緩衝區長度
LPCTSTR lpFileName // ini 檔案的檔名
);

這個 api 可以讀出整個 section 的內容，當你不知道 section 中有哪些 key 的時候，可以使用這個 api 將整個 section 讀出後再處理。

說明：

例ini檔案為：

[student]

Name=tian

Age=20

Sex=man

由GetPrivateProfileSection（）函式第二個引數lpReturnedString 返回的字串如下：

Name=tian"0Age=20"0Sex=man"0"0（每條以"0分割，最後以兩個"0結束）

而我們是想等到每個key及其對應的值，那怎麼分割上面那個字串呢？在VB有中個叫Split()函式，用起來很方便，但是vc裡面沒有。

當然，你也可以在VC中去實現一個Split()函式，不過我在這裡提供一個簡單的方法：

CString strKey;

         while(*str!='"0') //str為lpReturnedString返回的字串

         {       

                   strKey = str;

                   MessageBox(strKey); //strKey為每個key及其對應的值

                   str += strKey.GetLength()+1;

         }

GetPrivateProfileSectionNames - 從 ini 檔案中獲得 Section 的名稱，它的原形是：

GetPrivateProfileSectionNames(
LPTSTR lpszReturnBuffer, // 返回資料的緩衝區地址
DWORD nSize // 返回資料的緩衝區長度
LPCTSTR lpFileName // ini 檔案的檔名
);

如果 ini 中有兩個 Section: [sec1] 和 [sec2]，則返回的是 'sec1',0,'sec2',0,0 ，當你不知道 ini 中有哪些 section 的時候可以用這個 api 來獲取名稱

WritePrivateProfileSection - 將一個整個 Section 的內容入 ini 檔案的指定 Section 中，它的原形是：

WritePrivateProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字串地址
LPCTSTR lpString // 要寫入的資料的地址
LPCTSTR lpFileName // ini 檔案的檔名
);

WritePrivateProfileString - 將一個 Key 值寫入 ini 檔案的指定 Section 中，它的原形是：

WritePrivateProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字串地址
LPCTSTR lpString // 要寫的字串地址 
LPCTSTR lpFileName // ini 檔案的檔名
);

如果 ini 中沒有指定的 Section，API 會新建 Section，如果沒有指定的 Key 則新建一個 Key 並寫入資料，如果已經存在，則用字串代替原來的值。當指定的 ini 也不存在的時候，API 會自動建立一個新的檔案，所以使用 ini 的好處是我們不必為了儲存少量的資料涉及到檔案操作，就連查詢檔案是否存在的操作都不必要。

使用要點：

在我們實際使用的時候，用的最多的是 GetPrivateProfileString 和 WritePrivateProfileString，但在對自定義 ini 檔案操作的時候要注意的是，如果 lpFileName 指定的檔案沒有路徑的話，Api 會去 Windows 的安裝目錄去找而不會在當前目錄找，但是每次用到 ini 函式要獲取當前路徑顯然太麻煩了，這裡有一個變通的辦法，你只要在 ini 檔名前面加上 ." 就可以了，比如說要對本目錄下的 user.ini 操作，那麼檔名就是 '."user.ini' 這樣顯然比較方便。另外，當你要把一個 Key 清除的時候，可以使用把 lpString 指向一個空的字串然後使用 WritePrivateProfileString。當你要把一個 section 的全部內容清空的時候，也不必把 key 一個個的清除，可以使用把 lpString 指向一個空的字串然後使用 WritePrivateProfileSection。

--------------------------------

在我們寫的程式當中,總有一些配置資訊需要儲存下來,以便完成程式的功能,最簡單的辦法就是將這些資訊寫入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:"stud"student.ini 檔案中.

CString strName,strTemp;
int nAge;
strName="張三";
nAge=12;
::WritePrivateProfileString("StudentInfo","Name",strName,
"c:""stud""student.ini");　　此時c:"stud"student.ini檔案中的內容如下:

　　　[StudentInfo]

　　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");　　執行後 strStudName 的值為:”張三”,若前兩個引數有誤,其值為:”預設姓名”.

　　3.讀入整型值要用另一個WINAPI函式:

UINT GetPrivateProfileInt(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
INT nDefault,
LPCTSTR lpFileName
);　　這裡的引數意義與上相同.使用方法如下:

nStudAge=GetPrivateProfileInt("StudentInfo","Age",10,
"c:""stud""student.ini");三.迴圈寫入多個值,設現有一程式,要將最近使用的幾個檔名儲存下來,具體程式如下:

　　1.寫入:

CString strTemp,strTempA;
int i;
int nCount=6;
file://共有6個檔名需要儲存
for(i=0;i {strTemp.Format("%d",i);
strTempA=檔名;
file://檔名可以從陣列,列表框等處取得.
::WritePrivateProfileString("UseFileName","FileName"+strTemp,strTempA,
"c:""usefile""usefile.ini");
}
strTemp.Format("%d",nCount);
::WritePrivateProfileString("FileCount","Count",strTemp,
"c:""usefile""usefile.ini");
file://將檔案總數寫入,以便讀出.　　2.讀出:

nCount=::GetPrivateProfileInt("FileCount","Count",0,
"c:""usefile""usefile.ini");
for(i=0;i {strTemp.Format("%d",i);
strTemp="FileName"+strTemp;
::GetPrivateProfileString("CurrentIni",strTemp,
"default.fil", strTempA.GetBuffer(MAX_PATH),MAX_PATH,
"c:""usefile""usefile.ini");
file://使用strTempA中的內容.
}　　
如果 ini 中沒有指定的 Section，API 會新建 Section，如果沒有指定的 Key 則新建一個 Key 並寫入資料，如果已經存在，則用字串代替原來的值。當指定的 ini 也不存在的時候，API 會自動建立一個新的檔案，所以使用 ini 的好處是我們不必為了儲存少量的資料涉及到檔案操作，就連查詢檔案是否存在的操作都不必要。
使用要點：
    在我們實際使用的時候，用的最多的是 GetPrivateProfileString 和 WritePrivateProfileString，但在對自定義 ini 檔案操作的時候要注意的是，如果 lpFileName 指定的檔案沒有路徑的話，Api 會去 Windows 的安裝目錄去找而不會在當前目錄找，但是每次用到 ini 函式要獲取當前路徑顯然太麻煩了，這裡有一個變通的辦法，你只要在 ini 檔名前面加上 ./ 就可以了，比如說要對本目錄下的 user.ini 操作，那麼檔名就是 './user.ini' 這樣顯然比較方便。另外，當你要把一個 Key 清除的時候，可以使用把 lpString 指向一個空的字串然後使用 WritePrivateProfileString。當你要把一個 sectio的全部內容清空的時候，也不必把 key 一個個的清除，可以使用把 lpString 指向一個空的字串然後使用 WritePrivateProfileSection。

1.INI檔案的路徑必須完整,檔名前面的各級目錄必須存在,否則寫入不成功,該函式返回 FALSE 值.

2.檔名的路徑中必須為 "" ,因為在VC++中, "" 才表示一個 " .

3.也可將INI檔案放在程式所在目錄,此時 lpFileName 引數為: “.""student.ini”.