CFile:: abrir

virtual BOOL Aberto ( LPCTSTR lpszFileName, UINT nOpenFlags, CFileException * pError = Nulo );

Valor de retorno

Diferente de zero se o abrir foi bem-sucedida; caso contrário 0. O parâmetro pError é significativo apenas se 0 é retornado.

Parâmetros

lpszFileName

Uma Cadeia de caracteres que é o caminho para o arquivo desejado. O caminho pode ser relativo, absoluto ou um nome de rede (UNC).

nOpenFlags

Um UINT que define o modo de acesso e compartilhamento do arquivo. Especifica a ação a ser tomada quando abrindo o arquivo. Você pode combinar opções usando o operador bit a bit ou (|). Permissão de um acesso e uma partilha opção são necessários; o modeCreate e modeNoInherit modos são opcional. Consulte o Construtor de CFile para obter uma lista de opções do modo de.

pError

Um ponteiro para um objeto de exceção de arquivo existente que receberá o status de uma operação com falha.

Observações

Aberto é projetado para uso com o Construtor de CFile padrão. As duas funções formam um método "seguro" para abrir um arquivo onde uma falha é uma condição normal e esperada.

Enquanto o Construtor de CFile lançará uma exceção em uma condição de erro, Abrir retornará FALSE para condições de erro. Aberto ainda pode inicializar um objeto de CFileException para descrever o erro, no entanto. Se você não fornecer o parâmetro pError ou se você passar NULL para pError, Abrir irá retornar FALSE e não lançar um CFileException. Se você passar um ponteiro para um existente CFileExceptione Abrir encontra um erro, a função preencherá com informações descrevendo o erro. Em nenhum maiúscminúsc Abrir lançará uma exceção.

A tabela a seguir descreve os possíveis resultados do Open.

Exemplo

//exemplo de CFile:: abrir
CFile f;
CFileException e;
Char * pFileName = "test.dat";
se (! f.Open (pFileName, CFile::modeCreate | CFile::modeWrite, amp; e))
   {
# ifdef  Debug
   afxDump << "Arquivo não pôde ser aberto" << e.m_cause << "\n";
# endif
   }

Visão geral de CFile |  Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CFile:: CFile, CFile:: fechar