GetProfileIntW 函式 (winbase.h)

從 Win.ini 檔案指定區段中的索引鍵擷取整數。

注意 此函式僅適用於與16位 Windows 型應用程式的相容性。 應用程式應該將初始化資訊儲存在登錄中。

 

語法

UINT GetProfileIntW(
  [in] LPCWSTR lpAppName,
  [in] LPCWSTR lpKeyName,
  [in] INT     nDefault
);

參數

[in] lpAppName

包含索引鍵名稱的區段名稱。

[in] lpKeyName

要擷取其值之索引鍵的名稱。 此值的格式為字串; GetProfileInt 函式會將字串轉換成整數，並傳回整數。

[in] nDefault

如果在初始化檔案中找不到索引鍵名稱，則傳回的預設值。

傳回值

傳回值是 Win.ini 中索引鍵名稱之後字串的整數對等專案。 如果函式找不到索引鍵，則傳回值為預設值。 如果索引鍵的值小於零，則傳回值為零。

備註

如果索引鍵名稱是由數位所組成，後面接著不是數值的字元，則函式只會傳回數位的值。 例如，函式會針對下列這一行傳回 102：KeyName=102abc。

Windows Server 2003 和 Windows XP/2000： 對配置檔函式的呼叫可能會對應至登錄，而不是對應至初始化檔案。 當登入指定下列機碼下的初始化檔案和區段時，就會發生此對應：HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\IniFileMapping

當作業已對應時， GetProfileInt 函式會從登錄擷取資訊，而不是從初始化檔案擷取資訊;儲存位置中的變更不會影響函式的行為。

設定檔案函式會使用下列步驟來找出初始化資訊：

1. 在登錄中尋找 IniFileMapping 機碼下初始化檔案的名稱。
2. 尋找 lpAppName 所指定的區段名稱。 這會是索引鍵底下的具名值，其名稱為初始化檔的名稱，或是具有此名稱的子機碼，或名稱不存在為值或子機碼。
3. 如果 lpAppName 指定的區段名稱是具名值，則該值會指定登錄中的位置，您會找到區段的機碼。
4. 如果 lpAppName 指定的區段名稱是子機碼，則該子機碼下的具名值會指定登錄中的位置，您會找到區段的機碼。 如果您要尋找的機碼不存在為具名值，則會有未命名的值， (顯示為 <[無名稱> ]) ，指定您在登錄中找到密鑰的預設位置。
5. 如果 lpAppName 指定的區段名稱不存在為具名值或子機碼，則會有未命名的值 (顯示為 <[無名稱> ]) ，指定您在登錄中找到區段索引鍵的預設位置。
6. 如果沒有區段名稱的子機碼或專案，請尋找磁碟上的實際初始化檔案，並讀取其內容。

在登錄中查看指定其他登錄位置的值時，有數個前置詞會變更 .ini 檔案對應的行為：

• ! - 此字元會強制所有寫入至登錄和磁碟上的 .ini 檔案。
• # - 當新使用者第一次在安裝之後登入時，此字元會使登錄值設定為 Windows 3.1 .ini 檔案中的值。
• @ - 如果登錄中找不到要求的數據，此字元可防止任何讀取移至磁碟上的 .ini 檔案。
• USR： - 此前置詞代表 HKEY_CURRENT_USER，且前置詞之後的文字相對於該索引鍵。
• SYS：- 此前置詞代表 HKEY_LOCAL_MACHINE\SOFTWARE，而前置詞之後的文字則相對於該索引鍵。

注意

winbase.h 標頭會將 GetProfileInt 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

GetPrivateProfileInt

WriteProfileString