CWinApp::GetProfileString

Artykuł
02/27/2013

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

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.