CWinApp::WriteProfileString

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

アプリケーションのレジストリまたは .INI ファイルの指定のセクションに指定の文字列を書き込みます。

BOOL WriteProfileString(
   LPCTSTR lpszSection,
   LPCTSTR lpszEntry,
   LPCTSTR lpszValue 
);

パラメータ

lpszSection
エントリがあるセクションを指定する NULL で終わる文字列へのポインタ。セクションが存在しないときは、新たに作成されます。このセクション名は、大文字、小文字の区別をしません。文字列に大文字、小文字を組み合わせることができます。
lpszEntry
値を書き込むエントリを持つ NULL で終わる文字列へのポインタ。指定されたセクションにエントリが存在しないときは、新たに作成されます。このパラメータが NULL の場合、lpszSection で指定したセクションは削除されます。
lpszValue
書き込む文字列へのポインタ。この値が NULL の場合、lpszEntry で指定したエントリは削除されます。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

使用例

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」の例を参照してください。