CWinApp::GetProfileInt

Artículo
02/19/2013

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

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

Parámetros

lpszSection
Señala una cadena terminada en null que especifica la sección que contiene la entrada.
lpszEntry
Señala una cadena terminada en null que contiene la entrada cuyo valor se va a recuperar.
nDefault
Especifica el valor predeterminado para cambiar si el marco no puede encontrar la entrada.Este valor puede ser un valor sin signo en el intervalo de 0 a 65.535 o un valor con signo en el intervalo de – 32.768 a 32.767.

Valor devuelto

El valor entero de cadena tras la entrada especificada si la función es correcta.El valor devuelto es el valor del parámetro de nDefault si la función no encuentra la entrada.el valor devuelto es 0 si el valor que corresponde a la entrada especificada no es un entero.

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

Comentarios

Esta función miembro no distingue entre mayúsculas y minúsculas, por lo que las cadenas en los parámetros de lpszSection y de lpszEntry pueden diferir en caso de que.

Nota sobre la seguridad
Los datos devueltos por esta función no es necesariamente NULL finalizado, y el llamador debe realizar la validación.Para obtener más información, vea Para evitar las 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, vea CWinApp:: WriteProfileInt.