CWinApp::GetProfileString

發行項
02/28/2013

呼叫此成員函式以取得字串執行個體與指定的區段內的項目在應用程式的註冊或 .INI 檔。

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

參數

lpszSection
為指定包含項目的這個部分的 NULL 結尾字串的點。
lpszEntry
out 包含輸入字串要擷取的 NULL 結尾字串的點。這個值不可以是 NULL。
lpszDefault
對預設字串值的點指定項目時，如果輸入無法在初始設定檔案中找到。

傳回值

如果找不到，則傳回值是從應用程式的 .INI 檔或 lpszDefault 的字串。這個架構所支援的最大資料長度為 _MAX_PATH。如果 lpszDefault 是 NULL，傳回值為空字串。

備註

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

範例

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

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