Partager via


CWinApp::GetProfileString

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é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.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CWinApp, classe

Graphique de la hiérarchie

CWinApp::GetProfileInt

CWinApp::WriteProfileString

GetPrivateProfileString