CFile::Open

Artikel
02/26/2013

Überladen.Öffnen ist für die Verwendung mit dem Standard CFile-Konstruktor vorgesehen.

virtual BOOL Open(
   LPCTSTR lpszFileName,
   UINT nOpenFlags,
   CFileException* pError = NULL 
);
virtual BOOL Open(
   LPCTSTR lpszFileName,
   UINT nOpenFlags,
   CAtlTransactionManager* pTM,
   CFileException* pError = NULL
);

Parameter

lpszFileName
Eine Zeichenfolge, die der Pfad zur gewünschten Datei ist.Der Pfad kann relativ oder absolut, ein Netzwerkname (UNC) sein.
nOpenFlags
UINT, das die Freigabe und den Zugriffsmodus der Datei definiert.Es gibt die Aktion an, wenn die Datei geöffnet wird.Sie können Optionen kombinieren, indem Sie den bitweisen Operator OR verwenden (**|**Operator).Eine Zugriffsberechtigung und eine Aktienoption sind erforderlich; die modeCreate und modeNoInherit Modi sind optional.Siehe den Die C-Datei-Konstruktor für eine Liste von Modusoptionen.
pError
Ein Zeiger auf einen vorhandenen DateiAusnahme Objekt, das den Status eines fehlgeschlagenen Vorgangs empfängt.
pTM
Zeiger auf CAtlTransactionManager-Objekt

Rückgabewert

Ungleich 0 (null), wenn das geöffnete erfolgreich war; 0 andernfalls.Der pError-Parameter ist sinnvoll, wenn 0 zurückgegeben wird.

Hinweise

Die beiden Funktionen bilden eine "sichere" Methode zum Öffnen einer Datei, in der ein Fehler eine normale, erwartete Bedingung ist.

Während der CFile-Konstruktor eine Ausnahme in einem Fehlerzustand auslöst, gibt ÖffnenFALSE auf Fehlerzustände zurück.Öffnen kann ein CFileException-Objekt noch initialisieren, um den Fehler zu beschreiben, jedoch.Wenn Sie nicht den pError-Parameter angeben oder wenn Sie NULL für pError übergeben, gibt ÖffnenFALSE zurück und löst nicht CFileException aus.Wenn Sie einen Zeiger auf vorhandenen CFileException und Öffnen einen Fehler führen, füllt die Funktion er mit den Informationen aus, die diesen Fehler beschrieben werden.In auch nicht Fall werden Sie Öffnen muss eine Ausnahme.

Die folgende Tabelle beschreibt die möglichen Ergebnisse Öffnen.

pError	Fehler gefunden?	Rückgabewert	CFileExceptions-Inhalt
NULL	Nein	TRUE	nicht verfügbar
PTR zu CFileException	Nein	TRUE	unverändert
NULL	Ja	FALSE	nicht verfügbar
PTR zu CFileException	Ja	FALSE	initialisiert, um Fehler zu beschreiben

Beispiel

CFile f;
CFileException e;
TCHAR* pszFileName = _T("Open_File.dat");
if(!f.Open(pszFileName, CFile::modeCreate | CFile::modeWrite, &e))
{
   TRACE(_T("File could not be opened %d\n"), e.m_cause);
}

//A second example for CFile::Open.
//This function uses CFile to copy binary files.
bool BinaryFileCopy(LPCTSTR pszSource, LPCTSTR pszDest)
{
   // constructing these file objects doesn't open them
   CFile sourceFile;
   CFile destFile;

   // we'll use a CFileException object to get error information
   CFileException ex;

   // open the source file for reading
   if (!sourceFile.Open(pszSource,
      CFile::modeRead | CFile::shareDenyWrite, &ex))
   {
      // complain if an error happened
      // no need to delete the ex object

      TCHAR szError[1024];
      ex.GetErrorMessage(szError, 1024);
      _tprintf_s(_T("Couldn't open source file: %1024s"), szError);
      return false;
   }
   else
   {
      if (!destFile.Open(pszDest, CFile::modeWrite |
         CFile::shareExclusive | CFile::modeCreate, &ex))
      {
         TCHAR szError[1024];
         ex.GetErrorMessage(szError, 1024);
         _tprintf_s(_T("Couldn't open source file: %1024s"), szError);

         sourceFile.Close();
         return false;
      }

      BYTE buffer[4096];
      DWORD dwRead;

      // Read in 4096-byte blocks,
      // remember how many bytes were actually read,
      // and try to write that many out. This loop ends
      // when there are no more bytes to read.
      do
      {
         dwRead = sourceFile.Read(buffer, 4096);
         destFile.Write(buffer, dwRead);
      }
      while (dwRead > 0);

      // Close both files

      destFile.Close();
      sourceFile.Close();
   }

   return true;
}