CopyFile

9/8/2008

Esta função copia um arquivo existente para um novo arquivo. Um remoto versão API (RAPI) dessa função existe chamado CeCopyFile (RAPI).

Syntax

BOOL CopyFile(
  LPCTSTR lpExistingFileName, 
  LPCTSTR lpNewFileName, 
  BOOL bFailIfExists 
); 

Parameters

• lpExistingFileName
  [no] Ponteiro longo para um seqüência de caracteres NULL-Terminated que especifica o nome de um arquivo existente.

• lpNewFileName
  [no] Ponteiro longo para um seqüência de caracteres NULL-Terminated que especifica o nome do novo arquivo.

• bFailIfExists
  [no] Boolean que especifica como esta operação deve proceder se um arquivo com o mesmo nome como especificado por lpNewFileName já existe. Se este parâmetro for definido como TRUE e o novo arquivo já existe, o função falhar. Se este parâmetro for definido como FALSE e o novo arquivo já existe, a função sobrescreve a arquivo existente e é bem-sucedida.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Atributos de arquivo para o arquivo existente são copiados para o novo arquivo. Por exemplo, se um arquivo existente tem o atributo arquivo FILE_ATTRIBUTE_READONLY, um copiar criada por meio um chamar para essa função também tem FILE_ATTRIBUTE_READONLY. Para obter mais informações, consulte CreateFile.

Para armazenar o número máximo de arquivos no armazenamento cartão PC dispositivos, nomes arquivo limite para maiúscula oito caracteres e extensões arquivo para maiúscula três caracteres. Além disso, não permitir caracteres não-OEM em nomes arquivo. Nomes de arquivo que não estão em conformidade com esses limites exigem físico more than uma entrada Diretório em um cartão PC.

Essa função não funciona em diretórios.

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

File I/O Functions
CreateFile
MoveFile
DeleteAndRenameFile