CWinApp::GetProfileInt

Article
03/04/2013

Appelez la fonction membre pour récupérer la valeur d'un entier d'une entrée dans une section spécifiée dans le Registre ou 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 retourner si l'infrastructure ne peut pas trouver l'entrée.Cette valeur peut être une valeur non signée dans la plage 0 à 65.535 ou une valeur signée dans la plage – 32.768 à 32.767.

Valeur de retour

La valeur entière de la chaîne qui suit l'entrée spécifiée si la fonction est réussie.La valeur de retour est la valeur du paramètre d' 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 dans le fichier .ini.Lorsque vous récupérez un entier signé, vous devez effectuer un cast de la valeur dans int.

Notes

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

Note de sécurité
Les données retournées par cette fonction ne sont pas nécessairement fin 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.