CFile::Open

wirtualne BOOL Otwarte ( LPCTSTR lpszFileName, UINT nOpenFlags, CFileException * pError = NULL );

Wartość zwracany

Niezerowa, jeśli Otwórz zakończyła się pomyślnie; przeciwnym razie 0. Parametr pError ma znaczenie tylko wtedy, gdy zwracany jest 0.

Parametry

lpszFileName

Ciąg, który jest ścieżką do żądanego pliku. Ścieżka może być względna, bezwzględna lub nazwą sieciową (UNC).

nOpenFlags

UINT definiujący tryb udostępniania i dostępu pliku. Określa akcję do wykonania po otwarciu pliku. Opcje można łączyć za pomocą operatora logiczną lub (|). Wymagane są uprawnienia dostępu jeden i opcję jeden udziału; tryby modeCreate i modeNoInherit są opcjonalne. Zobacz konstruktora CFile listę opcji trybu.

pError

Wskaźnik do istniejącego obiektu pliku wyjątek, który zostanie wyświetlony stan Niepowodzenie operacji.

Uwagi

Otwarte jest przeznaczony do użytku z domyślnego konstruktora CFile . Dwie funkcje formularza "bezpieczne" metoda do otwierania pliku gdzie uszkodzenie jest normalna, przewidywany stan.

Podczas gdy konstruktora CFile wygeneruje wyjątek w warunek błędu, Otwórz zwróci Fałsz warunków błędów. Otwórz można nadal zainicjować obiektu CFileException do opisania błędu, jednak. Jeżeli nie podano parametru pError lub przesunięciu NULL dla pError, Open zwróci wartość FAŁSZ i nie rzucać CFileException. Jeśli przekazać wskaźnik do istniejących CFileExceptioni Otwórz wystąpi błąd, funkcja wypełni to informacje opisujące tego błędu. W przypadku ani otwartej wygeneruje wyjątek.

W poniższej tabeli opisano możliwe wyniki otwarte.

pError Napotkano błąd? Wartość zwracany Zawartość CFileException
WARTOŚĆ NULL Nr PRAWDA n/d!
pTR do CFileException Nr PRAWDA bez zmian
WARTOŚĆ NULL Tak FAŁSZ n/d!
pTR do CFileException Tak FAŁSZ zainicjowane do opisania błąd

Przykład

//Example do CFile::Open
CFile f;
CFileException e;
char * pFileName = "test.dat";
Jeżeli (! f.Open (pFileName, CFile::modeCreate | CFile::modeWrite, amp; e))
   {
#ifdef _DEBUG
   afxDump << "Pliku nie można otworzyć" << e.m_cause << "" \n";
#ENDIF
   }

Omówie&nie CFile |nbsp; Klasa członków | Wykres hierarchii

Zobacz też CFile::CFile, CFile::Close

Index