CException::ReportError

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

更新 : 2007 年 11 月

メッセージボックスでエラーテキストをユーザーにリポートします。

virtual int ReportError(
   UINT nType = MB_OK,
   UINT nMessageID = 0 
);

パラメータ

nType
メッセージボックスのスタイルを指定します。ボックスにはメッセージボックススタイルの任意の組み合わせを適用できます。このパラメータを指定しないと、既定で MB_OK になります。
nMessageID
例外オブジェクトがエラーメッセージを持っていないときに表示するメッセージのリソース ID (ストリングテーブルエントリ) を指定します。0 を指定すると、メッセージ "No error message is available" が表示されます。

戻り値

AfxMessageBox 値を返します。メッセージボックスを表示するためのメモリが不足している場合は 0 を返します。戻り値については、「AfxMessageBox」を参照してください。

使用例

CException::ReportError の使い方の例を示します。ほかの例については「CATCH」の例を参照してください。

CFile fileInput;
CFileException ex;

// try to open a file for reading.  
// The file will certainly not
// exist because there are too many explicit
// directories in the name.

// if the call to Open() fails, ex will be
// initialized with exception
// information.  the call to ex.ReportError() will
// display an appropriate
// error message to the user, such as
// "\Too\Many\Bad\Dirs.DAT contains an
// invalid path."  The error message text will be
// appropriate for the
// file name and error condition.

if (!fileInput.Open(_T("\\Too\\Many\\Bad\\Dirs.DAT"), CFile::modeRead, &ex))
{
   ex.ReportError();
}
else
{
   // the file was opened, so do whatever work
   // with fileInput we were planning...

   fileInput.Close();
}