CWinApp::GetProfileInt

發行項
02/28/2013

呼叫此成員函式從應用程式的註冊或 .INI 檔的指定區段中的項目擷取整數的值。

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

參數

lpszSection
為指定包含項目的這個部分的 NULL 結尾字串的點。
lpszEntry
out 包含輸入值要擷取之 null 結尾字串的點。
nDefault
如果此框架找不到項目，指定預設值所傳回。這個值可以是介於 0 到 65,535 的不帶正負號的值在此範圍 32,768 到 32,767 的帶正負號值。

傳回值

依照指定的輸入字串的整數值，如果函式進行。函式，如果找不到項目，則傳回值為 nDefault 參數的值。傳回值為 0，如果對應至指定項目的值不是整數。

此成員函式支援值的十六進位標記法在 .INI 檔。當您擷取帶正負號的整數時，應該將值轉換為 int。

備註

這個成員函式不區分大小寫，因此，在 lpszSection 和 lpszEntry 參數的字串可能會不同，以免。

安全性提示
這個函式傳回的資料不一定是以 null 結束，因此，呼叫端必須執行驗證。如需詳細資訊，請參閱避免緩衝區滿溢。

範例

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

如需其他範例，請參閱 CWinApp::WriteProfileInt。