CFile::em aberto
em aberto é criada para uso com o padrão de CFile construtor.
virtual BOOL Open(
LPCTSTR lpszFileName,
UINT nOpenFlags,
CFileException* pError = NULL
);
Parâmetros
lpszFileName
Uma seqüência de caracteres que é o caminho para o arquivo desejado.O caminho pode ser relativo, absoluto ou um nome de rede (UNC).nOpenFlags
A UINT que define o modo de compartilhamento e acesso do arquivo.Ele especifica a ação a ser tomada quando abrir o arquivo.Você pode agrupar opções usando o operador bit a bit ou (|) operador.São necessários; permissão de acesso de um e opção de uma partilha o modeCreate and modeNoInherit modos são opcionais.Consulte o CFile construtor para uma lista de opções do modo.pError
Um ponteiro para um objeto de exceção do arquivo existente que receberá o status de uma operação com falha.
Valor de retorno
Diferente de zero se a abertura foi bem-sucedida; caso contrário, 0.The pError parâmetro é útil apenas se 0 é retornado.
Comentários
As duas funções formam um método "seguro" para abrir um arquivo em que uma falha é uma condição normal e esperada.
Embora o CFile construtor lançará uma exceção em uma condição de erro em aberto retornará FALSE para condições de erro.em aberto ainda pode inicializar um CFileException objeto para descrever o erro, no entanto.Se você não fornecer o pError parâmetro, ou se você passar NULO for pError, em aberto retornará FALSE e não throw um CFileException. Se você passar um ponteiro para um existente CFileException, e em aberto encontra um erro, a função irá preenchê-lo com informações que descrevem esse erro.Em nenhum caso será em aberto lançar uma exceção.
A tabela a seguir descreve os resultados possíveis de em aberto.
pError |
Erro encontrado? |
Valor de Retorno |
Conteúdo CFileException |
---|---|---|---|
NULL |
Não |
TRUE |
n/d |
PTR para CFileException |
Não |
TRUE |
inalterado |
NULL |
Sim |
FALSE |
n/d |
PTR para CFileException |
Sim |
FALSE |
inicializado para descrever o erro |
Exemplo
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;
}
Requisitos
Cabeçalho: afx.h