CWinApp::GetProfileInt

Articolo
02/19/2013

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

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

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 a cui appartiene il valore deve essere recuperato.
nDefault
Specifica il valore predefinito per restituire se il framework impossibile trovare la voce.Questo valore può essere un valore senza segno compreso tra 0 e 65.535 oppure un valore con segno nell'intervallo (da 32.768 a 32.767.

Valore restituito

Il valore intero di stringa che segue la voce specifica 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 corrispondente alla voce specificato non è un Integer.

Questa funzione membro supporta la notazione esadecimale per il valore nel file di .INI.Quando si recupera un intero con segno, è necessario eseguire il cast del valore in int.

Note

Questa funzione membro non viene rilevata la distinzione tra maiuscole e minuscole, pertanto le stringhe nei parametri lpszEntry e lpszSection possono variare nel caso.

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

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.