GetPrivateProfileInt 函数 (winbase.h)

检索与初始化文件的指定节中的键关联的整数。

注意此函数仅用于与基于 Windows 的 16 位应用程序兼容。应用程序应在注册表中存储初始化信息。

语法

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 文件映射的行为：

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winbase.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll