CWinApp::GetProfileInt

项目
03/01/2013

调用该成员函数从应用程序的注册表或.INI文件中的指定部分中检索项的整数值。

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

参数

lpszSection
指向指定包含项的节的一个Null终止的字符串。
lpszEntry
指向包含项值要检索的一个Null终止的字符串。
nDefault
如果该结构找不到项，指定默认值返回。该值可以是在0到65,535之间的无符号值或在该范围(– 32,768到32,767的有符号值。

返回值

按照指定的项字符串的整数值，如果函数运行成功。如果该函数没有找到该项，则返回值是 nDefault 参数的值。返回值是0，则对应于指定的项的值不是整数。

此成员函数支持值的十六进制表示法在.INI文件。当您检索一个带符号整数时，应将值为 int。

备注

此成员函数不区分大小写，因此，在 lpszSection 和 lpszEntry 参数的字符串可能不同，以防。

安全说明
此函数返回的数据不一定是NULL终止，并且，调用方必须执行验证。有关更多信息，请参见避免缓冲区溢出。

示例

CWinApp* pApp = AfxGetApp();

const TCHAR* pszKey = _T("My Section"); 
const TCHAR* pszName = _T("Julian");
int iAge = 26;

// Write the information to the registry.

pApp->WriteProfileString(pszKey, _T("Name"), pszName);
pApp->WriteProfileInt(pszKey, _T("Age"), iAge);

// Read the information from the registry.

CString strName = pApp->GetProfileString(pszKey, _T("Name"));
int iAge2 = pApp->GetProfileInt(pszKey, _T("Age"), 0);

ASSERT(strName == pszName);
ASSERT(iAge2 == iAge);

有关其他示例，请参见 CWinApp::WriteProfileInt。