CWinApp::GetProfileInt

Статья
06/10/2015

Данный функцию-член для получения значения целого числа из записи в указанный раздел реестра или INI-файла приложения.

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

Параметры

lpszSection
Указывает на объединения завершенной строку, определяющую раздел, содержащий запись.
lpszEntry
Указывает на объединения завершенной строки, содержащей запись, значение которой требуется извлечь.
nDefault
Определяет значение по умолчанию для возврата, если среда не может найти запись.

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

Целочисленное значение строки, которая следует за указанную запись, если функция выполнена успешно. Возвращаемое значение является значением параметра 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.