CWinApp::GetProfileInt

Artículo
06/10/2015

Llame a esta función miembro para recuperar el valor de un entero de una entrada dentro de una sección especificada del registro o el archivo .INI de la aplicación.

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

Parámetros

lpszSection
Apunta a una cadena terminada en NULL que especifica la sección que contiene la entrada.
lpszEntry
Apunta a una cadena terminada en NULL que contiene la entrada cuyo valor se va a recuperar.
nDefault
Especifica el valor predeterminado que se devolverá si el marco no puede encontrar la entrada.

Valor devuelto

Valor entero de la cadena que hay a continuación de la entrada especificada si la función se realiza correctamente. El valor devuelto es el valor del parámetro nDefault si la función no encuentra la entrada. El valor devuelto es 0 si el valor correspondiente a la entrada especificada no es un entero.

Esta función miembro admite la notación hexadecimal para el valor del archivo .INI. Cuando se recupera un entero con signo, se debe convertir el valor a int.

Comentarios

Esta función miembro no distingue mayúsculas de minúsculas, por lo que las cadenas de los parámetros lpszSection y lpszEntry pueden tener un modelo distinto de mayúsculas y minúsculas.

Nota sobre la seguridad
Los datos devueltos por esta función no están terminados en NULL necesariamente y el llamador debe realizar la validación.Para obtener más información, vea Evitar saturaciones del búfer.

Ejemplo

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);

Para obtener un ejemplo adicional, vea CWinApp::WriteProfileInt.