CWinApp::GetProfileInt

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um den Wert einer ganzen Zahl aus einem Eintrag innerhalb eines angegebenen Abschnitt der der Registrierung oder der INI-Datei Anwendung abzurufen.

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

Parameter

lpszSection
Zeigt auf eine auf NULL endende Zeichenfolge, die den Abschnitt angibt, der den Eintrag enthält.
lpszEntry
Zeigt auf eine auf NULL endende Zeichenfolge, die den Eintrag enthält, dessen Wert abgerufen werden soll.
nDefault
Gibt den Standardwert an, um zurückzukehren, wenn das Framework den Eintrag nicht finden kann.Dieser Wert kann ein Wert ohne Vorzeichen im Bereich 0 bis 65.535 oder ein Wert mit im Bereich sein - 32.768 bis 32.767.

Rückgabewert

Der ganzzahlige Wert der Zeichenfolge, die dem angegebenen Eintrag folgt, wenn die Funktion erfolgreich.Der Rückgabewert ist der Wert des Parameters nDefault, wenn die Funktion nicht den Eintrag vorhanden.Der Rückgabewert ist 0, wenn der Wert, der dem angegebenen Eintrag entspricht, keine ganze Zahl ist.

Diese Memberfunktion unterstützt Hexadezimalnotation für den Wert in der INI-Datei.Wenn Sie eine Zahl mit Vorzeichen abrufen, sollten Sie den Wert in int umwandeln.

Hinweise

Diese Memberfunktion ist nicht Groß-/Kleinschreibung, sodass unterscheiden sich die Zeichenfolgen in den lpszSection und lpszEntry-Parametern nach.

Sicherheitshinweis
Die Daten, die von dieser Funktion zurückgegeben werden, sind nicht unbedingt NULL beendet, und der Aufrufer muss die Validierung ausführen.Weitere Informationen finden Sie unter Vermeiden von Pufferüberläufen.

Beispiel

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

Ein weiteres Beispiel finden Sie unter CWinApp::WriteProfileInt.