CFileException Class

Represents a file-related exception condition.

class CFileException : public CException

Members

Public Constructors

Name	Description
CFileException::CFileException	Constructs a CFileException object.

Public Methods

Name	Description
CFileException::ErrnoToException	Returns cause code corresponding to a run-time error number.
CFileException::GetErrorMessage	Retrieves the message describing an exception.
CFileException::OsErrorToException	Returns a cause code corresponding to an operating system error code.
CFileException::ThrowErrno	Throws a file exception based on a runtime error number.
CFileException::ThrowOsError	Throws a file exception based on an operating system error number.

Public Data Members

Name	Description
CFileException::m_cause	Contains portable code corresponding to the exception cause.
CFileException::m_lOsError	Contains the related operating-system error number.
CFileException::m_strFileName	Contains the name of the file for this exception.

Remarks

The CFileException class includes public data members that hold the portable cause code and the operating-system-specific error number. The class also provides static member functions for throwing file exceptions and for returning cause codes for both operating-system errors and C run-time errors.

CFileException objects are constructed and thrown in CFile member functions and in member functions of derived classes. You can access these objects within the scope of a CATCH expression. For portability, use only the cause code to get the reason for an exception. For more information about exceptions, see the article Exception Handling (MFC).

Inheritance Hierarchy

CObject

CException

CFileException

Requirements

Header: afx.h

See Also

Reference

CException Class

Hierarchy Chart

Other Resources

Exception Processing