GetProfileInt

声明

Declare Function GetProfileInt Lib "kernel32" Alias "GetProfileIntA" (ByVal lpAppName As String, ByVal lpKeyName As String, ByVal nDefault As Long) As Long

说明

取得win.ini初始化文件中指定条目的一个整数值

返回值

Long，找到条目的值；如指定的条目未找到，就返回默认值。如找到的数字不是一个合法的整数，函数就会返回其中合法的一部分。例如，对于“xyz=55zz”这个条目，函数会返回55。这个函数也能理解采用标准C语言格式的十六进制数字：用0x作为一个十六进制数字的前缀——所以0x55ab等价于vb的&H55AB

参数表

参数 类型及说明

lpAppName String，欲在其中搜索条目的小节名。这个字串不区分大小写

lpKeyName String，欲获取的项名或条目名。这个字串不区分大小写

nDefault Long，指定在条目未找到时返回的默认值

注解

参考对GetPrivateProfileInt函数的注解

类： CWinApp

头文件：afxwin.h

功能：

获取应用程序的注册表/.INI文件中指定部分的入口中的整数值。

语法：

UINT GetProfileInt(LPCTSTR lpszSection,LPCTSTR lpszEntry,int nDefault);

参数：

lpszSection 指向一个null结尾的字符串，指明包含入口的部分

lpszEntry 指向一个null结尾的字符串，包含了要获取值的入口

nDefault 指明当框架找不到入口时的默认返回值

返回值：

若函数执行成功，则返回指定入口下的字符串的整数值；

若没有找到入口，则返回值为nDefault的值；

若与指定入口对应的值不是整数，则返回值为零。

对.INI文件中的值，该函数支持16进制符号。当获得一个带符号整数时，必须将其值强制转换为整数值。

说明：

这些入口按照如下方式保存：

Windows NT: 该值保存在注册表里。

Windows 3.X: 该值保存在WIN.INI文件中。

Windows 95： 该值保存在WIN.INI的缓冲版本中。

该函数对大小写不敏感，因此lpszSection和lpszEntry参数中的字符串在大小写状态上可以是不同的。

/*****************************************************

演示函数原型：int nValue=GetProfileInt("MyApp","Value",0);

程序功能说明：获得应用程序注册表或.INI文件中“Value”键值下的二进制值。

*****************************************************/

//获得应用程序注册表或.INI文件中“Value”键值下的二进制值

int nValue=GetProfileInt("MyApp","Value",0);