CFile::Open

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

Valor devuelto

Distinto de cero si el abierto fue un éxito; 0 lo contrario. El parámetro pError sólo tiene sentido si se devuelve 0.

Parámetros

lpszFileName

Una cadena que es la ruta al archivo que desee. La ruta puede ser relativa, absoluta o un nombre de red (UNC).

nOpenFlags

Un UINT que define el modo de uso compartido y el acceso del archivo. Especifica la acción a tomar cuando se abre el archivo. Puede combinar opciones mediante el operador OR bit a bit (|). Permiso de uno acceso y una compartir opción son necesarios; los modos de modeCreate y modeNoInherit son opcionales. Vea el constructor CFile para obtener una lista de opciones de modo.

pError

Un puntero a un objeto de excepción de archivo existente que recibirá el estado de una operación fallida.

Observaciones

Abierto está diseñado para su uso con el constructor predeterminado de CFile . Las dos funciones forman un método "seguro" para abrir un archivo donde un fracaso es una condición normal y esperada.

Mientras que el constructor CFile producirá una excepción en una condición de error, abierta devolverá FALSE para las condiciones de error. Abierto todavía puede inicializar un objeto CFileException para describir el error, sin embargo. Si no se proporciona el parámetro pError , o si se pasa NULL para pError, abierto se devuelva FALSE y no tirar un CFileException. Si pasa un puntero a un existente CFileExceptiony abierto encuentra un error, la función rellenará con información que describe ese error. En ningún caso abierto producirá una excepción.

La tabla siguiente describen los posibles resultados del Open.

pError ¿Se encontró un error? Valor devuelto Contenido de CFileException
NULL No VERDADERO n/a
pTR para CFileException No VERDADERO sin cambios
NULL FALSO n/a
pTR para CFileException FALSO inicializado para describir el error

Ejemplo

//Example para CFile::Open
CFile f;
E CFileException;
Char * pFileName = "test.dat";
Si (! f.Open (pFileName, CFile::modeCreate | CFile::modeWrite, amp; e))
   {
# ifdef _DEBUG
   afxDump << "No se pudo abrir el archivo" << e.m_cause << "\n";
# endif
   }

Visió&n General de CFile |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CFile::CFile, CFile::Close

Index