getPrivateProfileIntW 函式 (winbase.h)
擷取與初始化檔案指定區段中索引鍵相關聯的整數。
語法
UINT GetPrivateProfileIntW(
[in] LPCWSTR lpAppName,
[in] LPCWSTR lpKeyName,
[in] INT nDefault,
[in] LPCWSTR lpFileName
);
參數
[in] lpAppName
初始化檔案中區段的名稱。
[in] lpKeyName
要擷取其值之索引鍵的名稱。 這個值的格式為字串; GetPrivateProfileInt 函 式會將字串轉換成整數,並傳回整數。
[in] nDefault
如果在初始化檔案中找不到索引鍵名稱,則傳回的預設值。
[in] lpFileName
初始化檔案的名稱。 如果此參數不包含檔案的完整路徑,系統會搜尋 Windows 目錄中的檔案。
傳回值
傳回值是指定初始化檔案中指定索引鍵名稱之後字串的整數對等專案。 如果找不到索引鍵,傳回值會是指定的預設值。
備註
函式會在檔案中搜尋符合 lpKeyName 參數所指定區段名稱下 lpKeyName 參數所指定名稱的索引鍵。 初始化檔案中的區段必須具有下列格式:
[section]
key=value
.
.
.
GetPrivateProfileInt 函式不區分大小寫;lpAppName和lpKeyName中的字串可以是大寫和小寫字母的組合。
應用程式可以使用 GetProfileInt 函 式,從 Win.ini 檔案擷取整數值。
系統會使用下列登錄機碼下定義的對應,將大部分 .ini 檔案參考對應:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\IniFileMapping
如果應用程式修改系統元件初始化檔案,例如 Control.ini、System.ini 和 Winfile.ini,則可能是這種對應。 在這些情況下,函式會從登錄擷取資訊,而不是從初始化檔案擷取資訊;儲存位置中的變更不會影響函式的行為。
設定檔函式會使用下列步驟來尋找初始化資訊:
- 在登錄中尋找 IniFileMapping 機碼下的初始化檔案名。
- 尋找 lpAppName所指定的區段名稱。 這會是索引鍵底下的具名值,其名稱為初始化檔案的名稱,或是具有此名稱的子機碼,或名稱不會以值或子機碼的形式存在。
- 如果 lpAppName 所指定的區段名稱是具名值,該值會指定登錄中您會找到區段索引鍵的位置。
- 如果 lpAppName 指定的區段名稱是子機碼,則該子機碼底下的具名值會指定在登錄中,您會找到區段的機碼。 如果您要尋找的機碼不存在為具名值,則會有未命名的值, (顯示為< [無名稱 >]) ,指定您在登錄中找到金鑰的預設位置。
- 如果lpAppName指定的區段名稱不存在為具名值或子機碼,則 (未命名的值 (顯示為< [無名稱 >]) ,指定您可以在登錄中找到區段索引鍵的預設位置。
- 如果區段名稱沒有子機碼或專案,請在磁片上尋找實際的初始化檔案,並讀取其內容。
- ! - 此字元會強制所有寫入至登錄和磁片上 .ini 檔案。
- # - 當新使用者第一次在安裝之後登入時,此字元會使登錄值設定為 Windows 3.1 .ini 檔案中的值。
- @ - 如果登錄中找不到要求的資料,此字元可防止任何讀取移至磁片上的 .ini 檔案。
- USR:此前置詞代表 HKEY_CURRENT_USER,而前置詞之後的文字則代表該索引鍵的相對。
- SYS:- 此前置詞代表 HKEY_LOCAL_MACHINE\SOFTWARE,而前置詞之後的文字會相對於該索引鍵。
注意
winbase.h 標頭會將 GetPrivateProfileInt 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | winbase.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |