CFile::Open

VirtualBOOLOpen (LPCTSTRlpszFileName,UINTnOpenFlags,CException *pErrorNULL=);

Valore restituito

Diverso da zero se all'aperto è stato completato; 0 altrimenti. Il parametro pError è significativo solo se viene restituito 0.

Parametri

lpszFileName

Una stringa che rappresenta il percorso per il file desiderato. Il percorso può essere un nome di rete (UNC), assoluto o relativo.

nOpenFlags

Un UINT che definisce la modalità di accesso e la condivisione dei file. Specifica l'azione da intraprendere quando si apre il file. È possibile combinare le opzioni utilizzando l'operatore OR bit per bit (|). L'autorizzazione di un accesso e una condivisione opzione sono richiesti; le modalità modeCreate e modeNoInherit sono facoltative. Vedere il costruttore CFile per un elenco delle opzioni di modalità.

pError

Un puntatore a un oggetto di eccezione file esistente che riceverà lo stato di un'operazione non riuscita.

Osservazioni

Open è stato progettato per l'utilizzo con il costruttore CFile predefinito. Le due funzioni formano un metodo "sicuro" per l'apertura di un file dove un fallimento è una condizione normale, attesa.

Mentre il costruttore CFile genererà un'eccezione in una condizione di errore, Open restituirà FALSE per le condizioni di errore. Aperto ancora possibile inizializzare un oggetto CException per descrivere l'errore, però. Se non viene fornito il parametro pError , o se si passa NULL per pError, Open restituirà FALSE e non genera un CException. Se passare un puntatore a un esistente CExceptione aperto viene rilevato un errore, la funzione si riempirà con informazioni che descrivono quell'errore. In nessun caso aperto genererà un'eccezione.

La seguente tabella descrive i risultati possibili degli Open.

pError Errore rilevato? Valore restituito CException contenuti
NULL No VERO n/a
pTR per CException No VERO invariato
NULL FALSI n/a
pTR per CException FALSI inizializzato per descrivere l'errore

Esempio

//example per CFile::Open
CFile f;
CException e;
char * pFileName = "test";
Se (! f.Open (pFileName, CFile:: modeCreate | CFile::modeWrite, amp; e))
   {
ifdef  debug
   afxDump << "File non può essere aperto" << e.m_cause << "\n";
# endif
   }

CFile pa&noramica |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CFile::CFile, CFile::Close

Index