CWinApp::GetProfileString

调用该成员函数检索该字符串与指定的节中的项在应用程序的注册表或.INI文件。

CString GetProfileString(
   LPCTSTR lpszSection,
   LPCTSTR lpszEntry,
   LPCTSTR lpszDefault = NULL 
);

参数

  • lpszSection
    指向指定包含项的节的一个Null终止的字符串。

  • lpszEntry
    指向包含项字符串要检索的一个Null终止的字符串。 此值不能为 NULL

  • lpszDefault
    如果项不能在初始化文件,找到指向特定项的默认字符串值。

返回值

;如果未能找到,则返回值是从应用程序的.INI文件或 lpszDefault 的字符串该字符串。 框架支持的最大字符串长度是 _MAX_PATH。 如果 lpszDefault 是 NULL,则返回值是空字符串。

备注

安全说明安全说明

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

示例

CWinApp* pApp = AfxGetApp();

CString strSection       = _T("My Section");
CString strStringItem    = _T("My String Item");
CString strIntItem       = _T("My Int Item");

pApp->WriteProfileString(strSection, strStringItem, _T("test"));

CString strValue;
strValue = pApp->GetProfileString(strSection, strStringItem);
ASSERT(strValue == _T("test"));

pApp->WriteProfileInt(strSection, strIntItem, 1234);

int nValue;
nValue = pApp->GetProfileInt(strSection, strIntItem, 0);
ASSERT(nValue == 1234);

有关其他示例,请 CWinApp::GetProfileInt请参见示例。

要求

Header: afxwin.h

请参见

参考

CWinApp选件类

层次结构图

CWinApp::GetProfileInt

CWinApp::WriteProfileString

GetPrivateProfileString