CFile::Open

Article
03/04/2013

Surchargé.Ouvrir est destiné à une utilisation avec le constructeur par défaut d' CFile .

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

Paramètres

lpszFileName
Une chaîne qui est le chemin d'accès au fichier souhaité.Le chemin d'accès peut être parent, absolu, ou un nom réseau UNC ().
nOpenFlags
uint Qui définit le partage de fichier et le mode d'accès.Il spécifie l'action à effectuer en ouvrant le fichier.Vous pouvez combiner des options à l'aide de opérateurs de bits OR (**|**Opérateur).Une autorisation d'accès et une option de partage sont requises ; les modes de modeCreate et de modeNoInherit sont facultatifs.Consultez le constructeur de fichier C pour une liste d'options d'état.
pError
Un pointeur vers un objet existant d'exception de fichier qui recevra l'état d'une opération ayant échoué.
pTM
Pointeur vers l'objet de CAtlTransactionManager

Valeur de retour

Une valeur différente de zéro si l'ouverture a réussi ; sinon 0.Le paramètre d' pError est pertinent uniquement si 0 est retourné.

Notes

Les deux fonctions forment une méthode « sécurisée » pour ouvrir un fichier où une erreur est une normale, état attendu.

Lorsque le constructeur d' CFile lève une exception dans une condition d'erreur, Ouvrir retourne FALSE pour les conditions d'erreur.Ouvrir peut toujours initialiser un objet de CFileException pour décrire l'erreur, cependant.Si vous ne fournissez pas le paramètre d' pError , ou si vous passez NULL pour pError, Ouvrir retourne FALSE et ne lève pas CFileException.Si vous passez un pointeur à CFileExceptionexistant, et les rencontre de Ouvrir une erreur, la fonction remplira d'informations décrivant cette erreur.Dans aucune de cas de Ouvrir lever une exception.

Le tableau suivant décrit les résultats possibles de Ouvrir.

pError	Erreur est survenue ?	Valeur de retour	Contenu de CFileException
NULL	Non	TRUE	N/A
prentice à CFileException	Non	TRUE	inchangé
NULL	Oui	FALSE	N/A
prentice à CFileException	Oui	FALSE	initialisé pour décrire l'erreur

Exemple

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