|
|
|
|
Win32彙編教程十三
您是第
466個瀏覽者
概述 在程式中經常要用到設置或者其他少量資料的存檔，以便程式在下一次執行的時候可以使用，比如說保存本次程式執行時視窗的位置、大小、一些用戶設置的資料等等，在 Dos 下編程的時候，我們一般自己產生一個檔，由自己把這些資料寫到檔中，然後在下一次執行的時候再讀出來使用。在 Win32 編程中當然你也可以這樣幹，但 Windows 已經為我們提供了兩種方便的辦法，那就是使用註冊表或者 ini 檔（Profile）來保存少量資料。本文中先介紹一下 .ini 檔的使用。
ini 檔是文字檔案，中間的資料格式一般為：
[Section1 Name]
KeyName1=value1
KeyName2=value2
...
[Section2 Name]
KeyName1=value1
KeyName2=value2
ini 檔可以分為幾個 Section，每個 Section 的名稱用 [] 括起來，在一個 Section 中，可以有很多的 Key，每一個 Key 可以有一個值並佔用一行，格式是 Key=value，Win32 對 ini 檔操作的 api 中，有一部分是對 win.ini 操作的，有一部分是對用戶自定義的 ini 檔操作的。Win.in 和 system.ini 是Windows的兩個非常重要的初始化檔，Windows將用戶所作的選擇以及各種變化的系統資訊記錄在這兩個檔中。System.ini 描述了系統硬體的當前狀態，Win.ini 檔則包含了Windows 系統運行環境的當前配置。由於 Win.ini 文件的重要性和常用性，Win32 中有專門對 Win.ini 進行操作的 api，它們是：
- 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 讀出後再處理。
- 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。
實用相關搜尋: it
|
〓中國黑客聯盟（CHU）〓前核心成員，現為榮譽會員
〓中國黑客聯盟（CHU）〓網絡電子雜誌《矩陣》編輯
風堂技術工作室
|
|
|
|
設為首頁
加入收藏
