getProfileIntA 函数 (winbase.h)
从 Win.ini 文件的指定节中的键中检索整数。
注意 此函数仅用于与基于 Windows 的 16 位应用程序兼容。 应用程序应在注册表中存储初始化信息。
语法
UINT GetProfileIntA(
[in] LPCSTR lpAppName,
[in] LPCSTR 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 函数从注册表检索信息，而不是从初始化文件中检索信息;存储位置中的更改不会影响函数的行为。
配置文件函数使用以下步骤来查找初始化信息：
- 在注册表中查找 IniFileMapping 键下的初始化文件的名称。
- 查找 lpAppName 指定的节名称。 这将是具有初始化文件名称的键下的命名值，或者具有此名称的子项，或者名称将不作为值或子项存在。
- 如果 lpAppName 指定的节名称是命名值，则该值指定在注册表中查找该节的键的位置。
- 如果 lpAppName 指定的节名称是一个子项，则该子项下的命名值将指定在注册表中查找该节的键的位置。 如果要查找的项不存在为命名值，则 (未命名的值显示为 <“无名称>) ”，指定在注册表中查找密钥的默认位置。
- 如果 lpAppName 指定的节名称不是作为命名值或子项存在的，则存在一个未命名的值 (显示为 <“无名称> ”) ，指定注册表中的默认位置，可在其中找到分区的键。
- 如果节名称没有子项或条目，请在磁盘上查找实际的初始化文件并读取其内容。
- ! - 此字符强制所有写入操作同时转到注册表和磁盘上的 .ini 文件。
- # - 当新用户在安装后首次登录时，此字符会导致注册表值设置为 Windows 3.1 .ini 文件中的值。
- @ - 如果注册表中找不到请求的数据，此字符将阻止任何读取操作转到磁盘上的 .ini 文件。
- USR： - 此前缀代表 HKEY_CURRENT_USER，前缀后面的文本相对于该键。
- SYS： - 此前缀代表 HKEY_LOCAL_MACHINE\SOFTWARE，前缀后面的文本相对于该键。
注意
winbase.h 标头将 GetProfileInt 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winbase.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |