Freigeben über


CWinApp::WriteProfileString

Rufen Sie die Memberfunktion auf, um die angegebene Zeichenfolge in den angegebenen Abschnitt der der Registrierung oder der INI-Datei Anwendung schreiben.

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

Parameter

  • lpszSection
    Zeigt auf eine auf NULL endende Zeichenfolge, die den Abschnitt angibt, der den Eintrag enthält. Wenn der Abschnitt nicht vorhanden ist, wird er erstellt. Der Name des handelt von Groß- und Kleinbuchstaben unabhängig; die Zeichenfolge kann jede beliebige Kombination von Groß- und Kleinbuchstaben.

  • lpszEntry
    Zeigt auf eine auf NULL endende Zeichenfolge, die den Eintrag enthält, in den der Wert geschrieben werden soll. Wenn der Eintrag nicht im angegebenen Abschnitt vorhanden ist, wird er erstellt. Wenn dieser Parameter NULL ist, ist der Abschnitt, der von lpszSection angegeben wird, gelöscht.

  • lpszValue
    Zeigt auf die geschrieben werden Zeichenfolge. Wenn dieser Parameter NULL ist, wird der Eintrag, der durch den lpszEntry-Parameter angegeben wird, gelöscht.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Beispiel

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

Ein weiteres Beispiel finden Sie im Beispiel für CWinApp::GetProfileInt.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CWinApp-Klasse

Hierarchiediagramm

CWinApp::GetProfileString

CWinApp::WriteProfileInt

WritePrivateProfileString

CWinApp::SetRegistryKey