CWinApp::GetProfileString

Článek
03/04/2013

Volání této funkce členů načíst řetězec přidružený záznam v zadaném oddílu v registru aplikace nebo.Soubor INI.

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

Parametry

lpszSection
Body řetězec zakončený hodnotou null, který určuje oddíl obsahující položky.
lpszEntry
Odkazuje na řetězec zakončený hodnotou null, který obsahuje položky, jejichž řetězec je k načtení.Tato hodnota nesmí být NULL.
lpszDefault
Odkazuje na výchozí hodnotu řetězce pro dané položky, pokud nelze najít položku v inicializačním souboru.

Vrácená hodnota

Vrácená hodnota je řetězec z dané aplikace.Soubor INI nebo lpszDefault Pokud řetězec nelze nalézt.Maximální délka řetězce podporovaných v rámci je _MAX_PATH .Pokud lpszDefault je NULL, vrácená hodnota je prázdný řetězec.

Poznámky

Poznámka k zabezpečení
Dat, kterou vrací tato funkce není nutně NULL ukončena a volající musí provést ověření.Další informace naleznete v tématu Vyhnout způsobí přetečení vyrovnávací paměti.

Příklad

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

Jiný příklad viz příklad pro CWinApp::GetProfileInt.