CWinApp::GetProfileString

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um die Zeichenfolge abzurufen, die mit einem Eintrag im angegebenen Abschnitt in der Registrierung oder in der INI-Datei Anwendung zugeordnet ist.

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

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 Zeichenfolge abgerufen werden soll.Dieser Wert darf nicht NULL sein.
lpszDefault
Zeigt auf den Standardzeichenfolgenwert für den angegebenen Eintrag, wenn der Eintrag nicht in der Initialisierungsdatei gefunden werden kann.

Rückgabewert

Der Rückgabewert ist die Zeichenfolge aus der der INI-Datei oder von lpszDefault Anwendung, wenn die Zeichenfolge nicht gefunden werden kann.Die maximale Zeichenfolgenlänge, die vom Framework unterstützt wird, ist _MAX_PATH.Wenn lpszDefaultNULL ist, ist der Rückgabewert eine leere Zeichenfolge.

Hinweise

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

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

Ein weiteres Beispiel finden Sie im Beispiel für CWinApp::GetProfileInt.