CWinApp::GetProfileString

Статья
06/10/2015

Эта функция-член вызывается с целью извлечения строка, связанная с записью в указанный раздел в реестре, либо ini-файле приложения.

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

Параметры

lpszSection
Указывает на null- завершенной строке, определяющая раздел, содержащий запись.
lpszEntry
Указывает на null- завершенной строке, которая содержит запись строка, которую требуется извлечь. Это значение не должно быть NULL.
lpszDefault
По умолчанию указывает на строковое значение для определенной записи, если запись не удалось найти в файле настройки.

Возвращаемое значение

Возвращаемое значение является строкой из ini-файла lpszDefault приложения или если строка не найдена. Максимальная длина строки, поддерживаемые платформой _MAX_PATH. Если lpszDefaultNULL, возвращаемым значением является пустая строка.

Заметки

Примечание по безопасности
Данные, возвращаемые этой функцией не обязательно является завершены 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.