CFile::Open

virtuelBOOLOuvert (LPCTSTRlpszFileName,UINTnOpenFlags,CFileException *pErrorNULL=);

Valeur de retour

Différent de zéro si l'ouverture a réussi ; sinon 0. Le paramètre pError est valable seulement si 0 est retourné.

Paramètres

lpszFileName

Une chaîne qui représente le chemin d'accès au fichier désiré. Le chemin d'accès peut être relative, absolue ou un nom de réseau (UNC).

nOpenFlags

Un UINT qui définit le mode de partage et d'accès du fichier. Il précise les mesures à prendre lors de l'ouverture du fichier. Vous pouvez combiner les options à l'aide de l'opérateur de bits OR (|). Autorisation d'un accès et une action option sont nécessaires ; les modes de modeCreate et modeNoInherit sont facultatifs. Consultez le constructeur CFile pour obtenir une liste des options de mode.

pError

Un pointeur vers un objet d'exception-fichier existant qui va recevoir le statut d'une opération qui a échoué.

Remarques

Ouvert est conçu pour une utilisation avec le constructeur de CFile par défaut. Les deux fonctions constituent une méthode « sûre » pour l'ouverture d'un fichier où un échec est une condition normale, prévue.

Alors que le constructeur CFile lèvera une exception dans une condition d'erreur, Open retourne la valeur FALSE pour les conditions d'erreur. Ouvert peut toujours initialiser un objet CFileException pour décrire l'erreur, cependant. Si vous ne fournissez pas le paramètre pError , ou si vous transmettez la valeur NULL pour pError, ouverte va retourner FALSE et pas jeter un CFileException. Si vous passez un pointeur à un existant CFileExceptionet Open rencontre une erreur, la fonction de le remplir avec des renseignements décrivant l'erreur. En aucun cas Ouvrir lèvera une exception.

Le tableau suivant décrit les résultats de l'Open.

Exemple

//Example pour CFile::Open
CFile f ;
CFileException e ;
char * pFileName = « test.dat » ;
Si (! f.Open (pFileName, CFile::modeCreate | CFile::modeWrite, amp; e))
   {
# ifdef _DEBUG
   afxDump << « Fichier impossible d'ouvrir » << e.m_cause << « \n » ;
# endif
   }

Aperçu de CFile |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CFile::CFile, CFile::Close