cuserexception-class.md

description	title	ms.date	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: CUserException Class	CUserException Class	11/04/2016	CUserException	operations [MFC], stopping exceptions [MFC], throwing CUserException class [MFC] errors [MFC], trapping operations [MFC] throwing exceptions [MFC], stopping user operations	2156ba6d-2cce-415a-9000-6f02c26fcd7d

CUserException Class

Thrown to stop an end-user operation.

Syntax

class CUserException : public CSimpleException

Remarks

Use CUserException when you want to use the throw/catch exception mechanism for application-specific exceptions. "User" in the class name can be interpreted as "my user did something exceptional that I need to handle."

A CUserException is usually thrown after calling the global function AfxMessageBox to notify the user that an operation has failed. When you write an exception handler, handle the exception specially since the user usually has already been notified of the failure. The framework throws this exception in some cases. To throw a CUserException yourself, alert the user and then call the global function AfxThrowUserException.

In the example below, a function containing operations that may fail alerts the user and throws a CUserException. The calling function catches the exception and handles it specially:

[!code-cppNVC_MFCExceptions#24]

For more information on using CUserException, see the article Exception Handling (MFC).

Inheritance Hierarchy

CObject

CException

CSimpleException

CUserException

Requirements

Header: afxwin.h

See also

Hierarchy Chart
CException Class