CWinApp::GetProfileString

Articolo
06/10/2015

Chiamare la funzione membro per recuperare la stringa associata a una voce nella sezione specificata nel Registro di sistema dell'applicazione o file di .INI.

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

Parametri

lpszSection
Punta a una stringa con terminazione null che specifica la sezione che contiene l'elemento.
lpszEntry
Punta a una stringa con terminazione null che contiene la voce della cui stringa deve essere recuperata. Questo valore non deve essere NULL.
lpszDefault
Punti al valore stringa predefinito per la voce specifica se la voce non è presente nel file di inizializzazione.

Valore restituito

Il valore restituito è la stringa dal file o da lpszDefault di .INI dell'applicazione se la stringa non è disponibile. La lunghezza massima della stringa supportati dal framework è _MAX_PATH. Se lpszDefault è NULL, verrà restituita una stringa vuota.

Note

Nota sulla sicurezza
I dati restituiti dalla funzione non sono necessariamente con terminazione null e il chiamante deve eseguire la convalida.Per ulteriori informazioni, vedere Evitare i sovraccarichi del buffer.

Esempio

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

Per un esempio, vedere l'esempio relativo CWinApp::GetProfileInt.