Home Library Learn Samples Downloads Support Community Forums
MSDN Library
Development Tools and Languages
Visual Studio 2012
Visual C++
MFC and ATL
MFC Desktop Applications
Classes
CWinApp Class
CWinApp::AddDocTemplate
CWinApp::AddToRecentFileList
CWinApp::ApplicationRecoveryCallback
CWinApp::CloseAllDocuments
CWinApp::CreatePrinterDC
CWinApp::CWinApp
CWinApp::DelRegTree
CWinApp::DoMessageBox
CWinApp::DoWaitCursor
CWinApp::EnableD2DSupport
CWinApp::EnableHtmlHelp
CWinApp::EnableShellOpen
CWinApp::EnableTaskbarInteraction
CWinApp::ExitInstance
CWinApp::GetApplicationRecoveryParameter
CWinApp::GetApplicationRecoveryPingInterval
CWinApp::GetApplicationRestartFlags
CWinApp::GetAppRegistryKey
CWinApp::GetDataRecoveryHandler
CWinApp::GetFirstDocTemplatePosition
CWinApp::GetHelpMode
CWinApp::GetNextDocTemplate
CWinApp::GetPrinterDeviceDefaults
CWinApp::GetProfileBinary
CWinApp::GetProfileInt
CWinApp::GetProfileString
CWinApp::GetSectionKey
CWinApp::HideApplication
CWinApp::HtmlHelp
CWinApp::InitInstance
CWinApp::IsTaskbarInteractionEnabled
CWinApp::LoadCursor
CWinApp::LoadIcon
CWinApp::LoadOEMCursor
CWinApp::LoadOEMIcon
CWinApp::LoadStandardCursor
CWinApp::LoadStandardIcon
CWinApp::LoadStdProfileSettings
CWinApp::m_bHelpMode
CWinApp::m_dwRestartManagerSupportFlags
CWinApp::m_eHelpType
CWinApp::m_hInstance
CWinApp::m_lpCmdLine
CWinApp::m_nAutosaveInterval
CWinApp::m_nCmdShow
CWinApp::m_pActiveWnd
CWinApp::m_pDataRecoveryHandler
CWinApp::m_pszAppName
CWinApp::m_pszExeName
CWinApp::m_pszHelpFilePath
CWinApp::m_pszProfileName
CWinApp::m_pszRegistryKey
CWinApp::m_pszAppID
CWinApp::OnContextHelp
CWinApp::OnDDECommand
CWinApp::OnFileNew
CWinApp::OnFileOpen
CWinApp::OnFilePrintSetup
CWinApp::OnHelp
CWinApp::OnHelpFinder
CWinApp::OnHelpIndex
CWinApp::OnHelpUsing
CWinApp::OnIdle
CWinApp::OpenDocumentFile
CWinApp::ParseCommandLine
CWinApp::PreTranslateMessage
CWinApp::ProcessMessageFilter
CWinApp::ProcessShellCommand
CWinApp::ProcessWndProcException
CWinApp::Register
CWinApp::RegisterShellFileTypes
CWinApp::RegisterWithRestartManager
CWinApp::ReopenPreviousFilesAtRestart
CWinApp::RestartInstance
CWinApp::RestoreAutosavedFilesAtRestart
CWinApp::Run
CWinApp::RunAutomated
CWinApp::RunEmbedded
CWinApp::SaveAllModified
CWinApp::SelectPrinter
CWinApp::SetHelpMode
CWinApp::SetRegistryKey
CWinApp::SupportsApplicationRecovery
CWinApp::SupportsAutosaveAtInterval
CWinApp::SupportsAutosaveAtRestart
CWinApp::SupportsRestartManager
CWinApp::Unregister
CWinApp::UnregisterShellFileTypes
CWinApp::WinHelp
CWinApp::WriteProfileBinary
CWinApp::WriteProfileInt
CWinApp::WriteProfileString
CWinApp::SetAppID
Expand Minimize
This topic has not yet been rated - Rate this topic

CWinApp::WriteProfileString

Visual Studio 2012

Call this member function to write the specified string into the specified section of the application's registry or .INI file.

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

Points to a null-terminated string that specifies the section containing the entry. If the section does not exist, it is created. The name of the section is case independent; the string may be any combination of uppercase and lowercase letters.

lpszEntry

Points to a null-terminated string that contains the entry into which the value is to be written. If the entry does not exist in the specified section, it is created. If this parameter is NULL, the section specified by lpszSection is deleted.

lpszValue

Points to the string to be written. If this parameter is NULL, the entry specified by the lpszEntry parameter is deleted.

Nonzero if successful; otherwise 0.

C++
Copy 
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);

For another example, see the example for CWinApp::GetProfileInt.

Header: afxwin.h

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.