CWinApp::GetProfileString

项目
03/01/2013

调用该成员函数检索该字符串与指定的节中的项在应用程序的注册表或.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请参见示例。