GetProfileInt是取得win.ini初始化檔案中指定條目的一個整數值。
基本介紹
- 外文名:GetProfileInt
- 註解:參考GetPrivateProfileInt函式
- 屬性:函式
- 詞性:名詞
VB,VC,介紹,示例,
VB
聲明
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函式的註解
VC
介紹
類: 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);