CFileException 수업

파일 관련 예외 상태를 나타냅니다.

구문

class CFileException : public CException

멤버

공용 생성자

공용 메서드

공용 데이터 멤버

설명

이 클래스에는 CFileException 이식 가능한 원인 코드와 운영 체제별 오류 번호를 포함하는 공용 데이터 멤버가 포함됩니다. 또한 이 클래스는 파일 예외를 throw하고 운영 체제 오류와 C 런타임 오류 모두에 대한 원인 코드를 반환하기 위한 정적 멤버 함수를 제공합니다.

CFileException 개체는 멤버 함수 및 파생 클래스의 멤버 함수에서 생성되고 throw CFile 됩니다. 식 범위 CATCH 내에서 이러한 개체에 액세스할 수 있습니다. 이식성을 위해 원인 코드만 사용하여 예외 이유를 가져옵니다. 예외에 대한 자세한 내용은 MFC(예외 처리) 문서를 참조하세요.

상속 계층 구조

CObject

CException

CFileException

요구 사항

머리글: afx.h

CFileException::CFileException

CFileException 원인 코드와 운영 체제 코드를 개체에 저장하는 개체를 생성합니다.

CFileException(
    int cause = CFileException::none,
    LONG lOsError = -1,
    LPCTSTR lpszArchiveName = NULL);

매개 변수

cause
예외의 이유를 나타내는 열거형 형식 변수입니다. 가능한 값 목록을 참조 CFileException::m_cause 하세요.

lOsError
사용 가능한 경우 예외에 대한 운영 체제별 이유입니다. 매개 변수는 lOsError 보다 cause 더 많은 정보를 제공합니다.

lpszArchiveName
예외를 일으키는 개체의 CFile 이름을 포함하는 문자열을 가리킵니다.

설명

이 생성자를 직접 사용하지 말고 전역 함수 AfxThrowFileException를 호출합니다.

CFileException::ErrnoToException

지정된 런타임 라이브러리 오류 값을 열거형 오류 값으로 CFileException 변환합니다.

static int PASCAL ErrnoToException(int nErrno);

매개 변수

nErrno
런타임 포함 파일에 ERRNO.H정의된 정수 오류 코드입니다.

Return Value

지정된 런타임 라이브러리 오류 값에 해당하는 열거형 값입니다.

설명

가능한 열거형 값 목록을 참조 CFileException::m_cause 하세요.

예시

ASSERT(CFileException::ErrnoToException(EACCES) == 
   CFileException::accessDenied);

CFileException::GetErrorMessage

예외를 설명하는 텍스트를 검색합니다.

virtual BOOL GetErrorMessage(
    LPTSTR lpszError,
    UINT nMaxError,
    PUINT pnHelpContext = NULL) const;

매개 변수

lpszError
[in, out] 오류 메시지를 받는 버퍼에 대한 포인터입니다.

nMaxError
[in] 지정된 버퍼가 보유할 수 있는 최대 문자 수입니다. 여기에는 종료 문자가 NULL 포함됩니다.

pnHelpContext
[in, out] 도움말 컨텍스트 ID를 받는 부호 없는 정수에 대한 포인터입니다. 이면 NULLID가 반환되지 않습니다.

Return Value

TRUE 메서드가 성공하면 이고, 그렇지 않으면 FALSE.

설명

지정된 버퍼가 너무 작으면 오류 메시지가 잘립니다.

예시

다음 예에서는 CFileException::GetErrorMessage를 사용합니다.

CFile fileInput;
CFileException ex;

// try to open a file for reading.
// The file will certainly not
// exist because there are too many explicit
// directories in the name.

// if the call to Open() fails, ex will be
// initialized with exception
// information.  the call to ex.GetErrorMessage()
// will retrieve an appropriate message describing
// the error, and we'll add our own text
// to make sure the user is perfectly sure what
// went wrong.

if (!fileInput.Open(_T("\\Too\\Many\\Bad\\Dirs.DAT"), CFile::modeRead, &ex))
{
   TCHAR szCause[255];
   CString strFormatted;

   ex.GetErrorMessage(szCause, 255);

   // (in real life, it's probably more
   // appropriate to read this from
   //  a string resource so it would be easy to
   // localize)

   strFormatted = _T("The data file could not be opened because of this error: ");
   strFormatted += szCause;

   AfxMessageBox(strFormatted);
}
else
{
   // the file was opened, so do whatever work
   // with fileInput
   // we were planning...

   fileInput.Close();
}

CFileException::m_cause

CFileException 열거형 형식으로 정의되는 값을 포함합니다.

int m_cause;

설명

이 데이터 멤버는 형식 int의 공용 변수입니다. 아래에 열거자와 해당 의미가 나와 있습니다.

예시

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();
}

CFileException::m_lOsError

이 예외에 대한 운영 체제 오류 코드를 포함합니다.

LONG m_lOsError;

설명

오류 코드 목록은 운영 체제 기술 설명서를 참조하세요. 이 데이터 멤버는 형식 LONG의 공용 변수입니다.

CFileException::m_strFileName

이 예외 조건에 대한 파일의 이름을 포함합니다.

CString m_strFileName;

CFileException::OsErrorToException

지정된 lOsError 값에 해당하는 열거자를 반환합니다. 오류 코드를 알 수 없는 경우 함수는 .를 반환합니다 CFileException::generic.

static int PASCAL OsErrorToException(LONG lOsError);

매개 변수

lOsError
운영 체제별 오류 코드입니다.

Return Value

지정된 운영 체제 오류 값에 해당하는 열거형 값입니다.

예시

ASSERT(CFileException::OsErrorToException(ERROR_ACCESS_DENIED) == 
   CFileException::accessDenied);

CFileException::ThrowErrno

지정된 nErrno 값에 CFileException 해당하는 개체를 생성한 다음 예외를 throw합니다.

static void PASCAL ThrowErrno(int nErrno, LPCTSTR lpszFileName = NULL);

매개 변수

nErrno
런타임 포함 파일에 ERRNO.H정의된 정수 오류 코드입니다.

lpszFileName
예외를 발생시킨 파일의 이름을 포함하는 문자열에 대한 포인터입니다(사용 가능한 경우).

예시

CFileException::ThrowErrno(EACCES);  // "access denied"

CFileException::ThrowOsError

지정된 lOsError 값에 CFileException 해당하는 값을 throw합니다. 오류 코드를 알 수 없는 경우 함수는 로 코딩된 CFileException::generic예외를 throw합니다.

static void PASCAL ThrowOsError(LONG lOsError, LPCTSTR lpszFileName = NULL);

매개 변수

lOsError
운영 체제별 오류 코드입니다.

lpszFileName
예외를 발생시킨 파일의 이름을 포함하는 문자열에 대한 포인터입니다(사용 가능한 경우).

예시

CFileException::ThrowOsError(ERROR_ACCESS_DENIED);  // "access denied"         

참고 항목

CException 클래스
계층 구조 차트
예외 처리