CWinApp::GetProfileInt
アプリケーションのレジストリまたは .INI ファイルの指定のセクション内のエントリから整数値を取得します。
UINT GetProfileInt(
LPCTSTR lpszSection,
LPCTSTR lpszEntry,
int nDefault
);
パラメーター
lpszSection
エントリがあるセクションを指定する NULL で終わる文字列へのポインター。lpszEntry
値を取得するエントリを指定する NULL で終わる文字列へのポインター。nDefault
フレームワークがエントリを見つけられなかったときのために指定する既定値。0 から 65,535 の符号なしの値、または -32,768 から 32,767 までの符号付きの値を指定できます。
戻り値
正常終了した場合は、指定されたエントリに続く文字列の整数値を返します。エントリが見つからなかった場合は、パラメーター nDefault の値を返します。指定されたエントリに対応する値が整数でない場合は、0 を返します。
このメンバー関数は .INI ファイル内の値として 16 進表記をサポートします。符号付き整数を取得したときは、int にキャストしてください。
解説
このメンバー関数は、大文字、小文字の区別をしないので、lpszSection と lpszEntry の文字列は大文字、小文字のどちらでもかまいません。
.gif "セキュリティに関するメモ") セキュリティに関するメモ |
|---|
この関数が返すデータは、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」を参照してください。
必要条件
ヘッダー: afxwin.h