CWinApp::GetProfileString

Article
03/04/2013

Appelez la fonction membre pour récupérer la chaîne associée à une entrée dans la section spécifiée dans le Registre ou le fichier .ini de l'application.

CString GetProfileString(
   LPCTSTR lpszSection,
   LPCTSTR lpszEntry,
   LPCTSTR lpszDefault = NULL 
);

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 chaîne doit être récupérée.Cette valeur ne doit pas être NULL.
lpszDefault
Points à la valeur de chaîne par défaut pour l'entrée donnée si l'entrée ne peut pas être trouvée dans le fichier d'initialisation.

Valeur de retour

La valeur de retour est la chaîne du fichier .ini ou d' lpszDefault de l'application si la chaîne est introuvable.La longueur maximale de la chaîne charge par l'infrastructure est _MAX_PATH.Si lpszDefault est NULL, la valeur de retour est une chaîne vide.

Notes

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

CString strSection       = _T("My Section");
CString strStringItem    = _T("My String Item");
CString strIntItem       = _T("My Int Item");

pApp->WriteProfileString(strSection, strStringItem, _T("test"));

CString strValue;
strValue = pApp->GetProfileString(strSection, strStringItem);
ASSERT(strValue == _T("test"));

pApp->WriteProfileInt(strSection, strIntItem, 1234);

int nValue;
nValue = pApp->GetProfileInt(strSection, strIntItem, 0);
ASSERT(nValue == 1234);

Pour obtenir un autre exemple, consultez l'exemple pour CWinApp::GetProfileInt.