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); ^[1] 

參數：

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);