CFileException类学习
CFileException
类学习笔记
2007-7-18
CFileException
类的声明文件保存在头文件
afx.h
中。
当我们在使用
CFile
及其派生类的对象的时候，如果产生异常则会创建和抛出
CFileException
对象。采用
TRY…CATCH…END_CATCH
。
CFileException
类的成员变量：
m_cause
：错误代码
CFileException::none
没有错误发生
CFileException::generic
一个未被指明的错误发生
CFileException::fileNotFind
该文件不能被定位
CFileException::badPath
整个或者部分路径是无效的
CFileException::tooManyOpenFiles
打开文件的数目太多
CFileException::accessDenied
文件不能被访问
CFileException::invalidFile
试图使用无效文件的句柄
CFileException::removeCurrentDir
当前工作路径不能被移除
CFileException::directoryFull
不再有目录项
CFileException::badSeek
试图设置文件指针错误
CFileException::hardIO
硬件错误
CFileException::sharingViolation
不能调用
share.exe
文件，或者共享区域被锁
CFileException::lockViolation
试图锁定一个已经被锁的区域
CFileException::diskFull
磁盘空间已满
CFileException::endOfFile
访问到文件尾部
m_IOsEror
：操作系统异常错误代码，
LONG
型
m_strFileName
：产生异常情况的文件名称，
CString
型
CFileException
类的成员变量：
CFileException(
int cause = CFileException::none,
异常原因代码
LONG IOsError = -1,
操作系统提示的错误
LPCTSTR lpszArchiveName = NULL
产生错误的
CFile
对象
);
除了使用全局函数
AfxThrowFileException
，不能直接创建一个异常文件对象。
注意：
IOsError
只能应用在
CFile
和
CStdioFile
类产生的对象中。
CMemFile
对象不能操作该错误代码。
static int PASCAL ErrnoToException(int nErrno);
将运行时的错误值转换为一个
CFileException
被枚举定义的错误值
nErrno
：指的是头文件
ERRNO.H
中定义的运行时错误值
该函数返回与运行时错误相对应的枚举值
static int PASCAL OsErrorToException(LONG IOsError);
将操作系统产生的错误值转换为一个
CFileException
被枚举定义的错误值
IOsError
：指的是操作系统指定的错误值
该函数返回与操作系统错误相对应的枚举值，如果该错误没有对应的
CFileException
定义的错误值，则会返回
CFileException::generic
static void PASCAL ThrowErrno(
int nErrno,
LPCTSTR lpszFileName = NULL
);
构造一个与
ERRNO.H
头文件声明的错误值一致的
CFileException
对象，并抛出该异常。
static void PASCAL ThrowOsError(
LONG IOsError,
LPCTSTR lpszFileName = NULL
);
抛出一个与操作系统错误一致的
CFileException
对象，如果
IOsError
错误代码不可知，则抛出异常代码
CFileException::generic