CWinApp::GetProfileInt

發行項
06/10/2015

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

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

參數

lpszSection
對指定包含輸入的這個部分以 Null 結束之字串的點。
lpszEntry
包含值被擷取的輸入以 Null 結束之字串的點。
nDefault
如果此框架找不到項目，指定預設值傳回。

傳回值

如果函式成功，跟在指定輸入字串的整數值。如果找不到項目，則傳回值為 nDefault 參數的值。如果對應到指定項目的值不是整數則傳回值為 0。

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

備註

此成員函式不區分大小寫，因此，在 lpszSection 和 lpszEntry 參數的字串以防萬一可能不同。

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

範例

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。