CWinApp::GetProfileInt

Article
06/10/2015

Appelez cette fonction membre pour récupérer la valeur d'un entier d'une entrée dans une section spécifiée du Registre ou dans le fichier INI de l'application.

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

Paramètres

lpszSection
Pointe vers une chaîne terminée par le caractère NULL qui spécifie la section contenant l'entrée.
lpszEntry
Pointe vers une chaîne terminée par le caractère NULL qui contient les entrées dont la valeur doit être récupérée.
nDefault
Spécifie la valeur par défaut pour revenir si l'infrastructure ne peut pas trouver l'entrée.

Valeur de retour

La valeur entière de la chaîne qui suit l'entrée spécifiée si la fonction est exécutée avec brio. La valeur de retour est la valeur du paramètre nDefault si la fonction ne trouve pas l'entrée. La valeur de retour est 0 si la valeur qui correspond à l'entrée spécifiée n'est pas un entier.

Cette fonction membre prend en charge la notation hexadécimale pour la valeur contenue dans le fichier.ini. Lorsque vous récupérez un entier signé, vous devez distribuer la valeur dans int.

Notes

Cette fonction membre ne respecte pas la casse, donc les chaînes de caractères dans lpszSection et les paramètres lpszEntry peuvent différer de casse.

Note de sécurité
Les données retournées par cette fonction ne sont pas nécessairement terminées par la valeur null, et l'appelant doit effectuer la validation.Pour plus d'informations, consultez Solutions contre les dépassements de mémoire tampon.

Exemple

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

Pour obtenir un exemple supplémentaire, consultez CWinApp::WriteProfileInt.