Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
CUserException Class
Collapse the table of content
Expand the table of content

CUserException Class 

Thrown to stop an end-user operation.

class CUserException : public CSimpleException

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:

void DoSomeOperation( )
    // Processing
    // If something goes wrong...
    AfxMessageBox( "The x operation failed" );
    AfxThrowUserException( );

BOOL TrySomething( )
        // Could throw a CUserException or other exception.
        DoSomeOperation( ); 
    CATCH( CUserException, e )
        return FALSE;    // User already notified.
    AND_CATCH( CException, e )
        // For other exception types, notify user here.
        AfxMessageBox( "Some operation failed" );
        return FALSE;
    return TRUE;   // No exception thrown.

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

Header: afxwin.h

Community Additions

© 2015 Microsoft