CWinApp::GetProfileInt

Artykuł
02/27/2013

Wywołać funkcję Członkowskie pobrać wartość całkowitą z wpisu w określonej sekcji rejestru aplikacji lub.Plik INI.

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

Parametry

lpszSection
Wskazuje ciąg zakończony zerem, określający sekcji zawierającej zapis.
lpszEntry
Wskazuje ciąg zakończony zerem, zawierający zapis, którego wartość ma być pobrana.
nDefault
Określa domyślną wartość do zwrotu, jeżeli ramy nie może znaleźć wpisu.Ta wartość może być niepodpisany wartość z zakresu od 0 do 65 535 lub podpisane wartości w zakresie –32, 768 do 32 767.

Wartość zwracana

Całkowitą wartość ciągu następujący określonego wpisu, jeśli funkcja się powiedzie.Wartość zwracana jest wartość nDefault parametr, jeśli funkcja nie może znaleźć wpisu.Zwracana jest wartość 0, jeżeli wartość, która odpowiada określony wpis nie jest liczbą całkowitą.

Funkcja Członkowskie obsługuje wartości w notacji szesnastkowej.Plik INI.Podczas pobierania liczba całkowita ze znakiem powinno rzutować wartości do int.

Uwagi

Członkowskie funkcja nie jest uwzględniana, więc ciągi w lpszSection i lpszEntry parametry mogą różnić się w przypadku.

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

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

Na przykład dodatkowe, zobacz CWinApp::WriteProfileInt.