CWinApp::GetProfileInt

Статья
02/20/2013

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

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

Параметры

lpszSection
Указывает на null- завершенной строке, определяющая раздел, содержащий запись.
lpszEntry
Указывает на null- завершенной строке, которая содержит запись, значение которой требуется извлечь.
nDefault
Определяет значение по умолчанию для возвращения если границы не могут найти запись.Это значение может быть unsigned значение в диапазоне от 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.