CWinApp::GetProfileInt
更新 : 2007 年 11 月
アプリケーションのレジストリまたは .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」を参照してください。
スマート デバイス開発者のためのメモ
CWinApp::SetRegistryKey を使用したレジストリに基づくバージョンのみが、Windows CE ベースのプロジェクトでサポートされます。
必要条件
ヘッダー : afxwin.h