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

Visual Studio 2012

Call this member function to retrieve the string associated with an entry within the specified section in the application's registry or .INI file.

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

Points to a null-terminated string that specifies the section containing the entry.

lpszEntry

Points to a null-terminated string that contains the entry whose string is to be retrieved. This value must not be NULL.

lpszDefault

Points to the default string value for the given entry if the entry cannot be found in the initialization file.

The return value is the string from the application's .INI file or lpszDefault if the string cannot be found. The maximum string length supported by the framework is _MAX_PATH. If lpszDefault is NULL, the return value is an empty string.

Security note Security Note

The data returned by this function is not necessarily NULL terminated, and the caller must perform validation. For more information, see Avoiding Buffer Overruns.
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.
|
Site Feedback
© 2013 Microsoft. All rights reserved.