GetPrivateProfileInt 函式 (winbase.h)

在初始化檔案的指定區段中擷取與索引鍵相關聯的整數。

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

語法

UINT GetPrivateProfileInt(
  [in] LPCTSTR lpAppName,
  [in] LPCTSTR lpKeyName,
  [in] INT     nDefault,
  [in] LPCTSTR lpFileName
);

[in] lpAppName

初始化檔中區段的名稱。

[in] lpKeyName

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

[in] nDefault

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

[in] lpFileName

初始化檔的名稱。如果此參數不包含檔案的完整路徑，系統就會搜尋 Windows 目錄中的檔案。

傳回值是指定初始化檔中指定索引鍵名稱之後字串的整數對等專案。如果找不到索引鍵，則傳回值是指定的預設值。

函式會在 lpAppName 參數所指定的區段名稱下，搜尋符合 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 檔案對應的行為：