CWinApp::GetProfileString
Wywołać funkcję Członkowskie pobrać ciągu skojarzone z wpisu w sekcji określony w rejestrze aplikacji lub.Plik INI.
CString GetProfileString(
LPCTSTR lpszSection,
LPCTSTR lpszEntry,
LPCTSTR lpszDefault = NULL
);
Parametry
lpszSection
Wskazuje ciąg zakończony zerem, określający sekcji zawierającej zapis.lpszEntry
Wskazuje ciąg zakończony znakiem null, zawierający zapis, w ciągu którego ma być pobrana.Wartość ta nie musi być NULL.lpszDefault
Wskazuje domyślną wartość ciągu dla danego wpisu, jeżeli zapis nie można odnaleźć pliku inicjującego.
Wartość zwracana
Zwracana wartość jest ciągiem z aplikacji.Plik INI lub lpszDefault , jeśli nie można odnaleźć ciągu.Maksymalna długość ciągu obsługiwane w ramach jest _MAX_PATH.Jeśli lpszDefault jest NULL, zwracana jest wartość pusty ciąg.
Uwagi
.gif "Uwaga dotycząca zabezpieczeń") Uwaga dotycząca zabezpieczeń |
|---|
Dane zwrócone przez tę funkcję nie jest koniecznie NULL zakończone i wywołujący musi wykonać sprawdzanie poprawności.Aby uzyskać więcej informacji, zobacz Overruns buforu unikanie. |
Przykład
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);
Innym przykładem, zobacz przykład dla CWinApp::GetProfileInt.
Wymagania
Nagłówek: afxwin.h