Partager via


CWinApp::WriteProfileString

Appelez la fonction membre pour écrire la chaîne spécifiée dans la section spécifiée dans le Registre ou le fichier .ini de l'application.

BOOL WriteProfileString( 
   LPCTSTR lpszSection, 
   LPCTSTR lpszEntry, 
   LPCTSTR lpszValue  
);

Paramètres

  • lpszSection
    Pointe vers une chaîne terminée par le caractère NULL qui spécifie la section contenant l'entrée. Si la section n'existe pas, il est créé. Le nom de la section est distinguant ne pas la casse ; la chaîne peut être toute combinaison de majuscules et des minuscules.

  • lpszEntry
    Pointe vers une chaîne terminée par le caractère NULL qui contient l'entrée dans laquelle la valeur doit être écrite. Si l'entrée n'existe pas dans la section spécifiée, elle est créée. Si ce paramètre est NULL, la section spécifiée par lpszSection est désactivée.

  • lpszValue
    Pointe vers une chaîne à écrire. Si ce paramètre est NULL, l'entrée spécifiée par le paramètre d' lpszEntry est désactivée.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

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::GetProfileString

CWinApp::WriteProfileInt

WritePrivateProfileString

CWinApp::SetRegistryKey