CWinApp::GetProfileInt

Articolo
06/10/2015

Chiamare la funzione membro per recuperare il valore di un integer da una voce in una sezione specifica del registro dell'applicazione o del file .INI.

UINT GetProfileInt( 
   LPCTSTR lpszSection, 
   LPCTSTR lpszEntry, 
   int nDefault  
);

Parametri

lpszSection
Punta a una stringa con terminazione null che specifica la sezione che contiene la voce.
lpszEntry
Punta a una stringa con terminazione null che contiene la voce il cui valore deve essere recuperato.
nDefault
Specifica il valore predefinito per restituire se il framework non riesce trovare la voce.

Valore restituito

Il valore intero della stringa che segue la voce specificata se la funzione ha esito positivo. Il valore restituito è il valore del parametro nDefault se la funzione non trova la voce. Il valore restituito è 0 se il valore che corrisponde alla voce specificata non è un integer.

Questa funzione supporta la notazione esadecimale per il valore nel file .INI. Quando si recupera un signed integer, è necessario eseguire il cast del valore a int.

Note

Questa funzione non è case sensitive, quindi le stringhe nei parametri lpszEntry e lpszSection possono variare in maiuscole/minuscole.

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 sovraccarichi del buffer.

Esempio

CWinApp* pApp = AfxGetApp();

const TCHAR* pszKey = _T("My Section"); 
const TCHAR* pszName = _T("Julian");
int iAge = 26;

// Write the information to the registry.

pApp->WriteProfileString(pszKey, _T("Name"), pszName);
pApp->WriteProfileInt(pszKey, _T("Age"), iAge);

// Read the information from the registry.

CString strName = pApp->GetProfileString(pszKey, _T("Name"));
int iAge2 = pApp->GetProfileInt(pszKey, _T("Age"), 0);

ASSERT(strName == pszName);
ASSERT(iAge2 == iAge);

Per un altro esempio, vedere CWinApp::WriteProfileInt.