CFileException::m_cause

Contains values defined by a CFileException enumerated type.

int m_cause;

Remarks

This data member is a public variable of type int. The enumerators and their meanings are as follows:

  • CFileException::none   No error occurred.

  • CFileException::genericException   An unspecified error occurred.

  • CFileException::fileNotFound   The file could not be located.

  • CFileException::badPath   All or part of the path is invalid.

  • CFileException::tooManyOpenFiles   The permitted number of open files was exceeded.

  • CFileException::accessDenied   The file could not be accessed.

  • CFileException::invalidFile   There was an attempt to use an invalid file handle.

  • CFileException::removeCurrentDir   The current working directory cannot be removed.

  • CFileException::directoryFull   There are no more directory entries.

  • CFileException::badSeek   There was an error trying to set the file pointer.

  • CFileException::hardIO   There was a hardware error.

  • CFileException::sharingViolation   SHARE.EXE was not loaded, or a shared region was locked.

  • CFileException::lockViolation   There was an attempt to lock a region that was already locked.

  • CFileException::diskFull   The disk is full.

  • CFileException::endOfFile   The end of file was reached.

    Note

    These CFileException cause enumerators are distinct from the CArchiveException cause enumerators.

    Note

    CArchiveException::generic is deprecated. Use genericException instead. If generic is used in an application and built with /clr, there will be syntax errors that are not easy to decipher.

Example

try
{
    CFile f(_T("M_Cause_File.dat"), CFile::modeWrite);
}
catch(CFileException* e)
{
    if( e->m_cause == CFileException::fileNotFound)
        TRACE(_T("ERROR: File not found\n"));
    e->Delete();
}

Requirements

Header: afx.h

See Also

Reference

CFileException Class

Hierarchy Chart

Other Resources

CFileException Members