CopyFileEx

9/8/2008

Esta função copia um arquivo existente para um novo arquivo.

Syntax

BOOL CopyFileEx(
  LPCTSTR lpExistingFileName, 
  LPCTSTR lpNewFileName,
  LPPROGRESS_ROUTINE lpProgressRoutine,
  LPVOID lpData,
  LPBOOL pbCancel,
  DWORD dwCopyFlags
); 

Parameters

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

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

• lpProgressRoutine
  [no] Endereço de uma função callback que é chamado cada tempo outra parte do arquivo foi copiado. Este parâmetro pode ser definido como NULL.

• lpData
  [no] Parâmetro a serem passados para o função callback. Este parâmetro pode ser definido como NULL.

• pbCancel
  [no] Se este parâmetro for definido como TRUE durante operação de copiar, a operação foi cancelada. Caso contrário, a operação copiar continua a conclusão.

• dwCopyFlags
  [no] Sinalizadores que especificar como o arquivo é a serem copiados. Este parâmetro pode ser definido para qualquer combinação de valores mostrada a seguinte tabela.

  Valor	Descrição
  COPY_FILE_ALLOW_DECRYPTED_DESTINATION	Tentar copiar um arquivo criptografado for bem-sucedido, Even if copiar o destino não pode ser criptografado.
  COPY_FILE_FAIL_IF_EXISTS	A operação copiar imediatamente falhará se o arquivo destino já existe.
  COPY_FILE_RESTARTABLE	Progresso da copiar é controlado de destino arquivo no maiúsculas e minúsculas a copiar falha. A falha copiar pode ser reiniciado em um tempo posterior especificando os mesmos valores para lpExistingFileName e lpNewFileName como aqueles utilizados na chamar essa falha.

Return Value

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

Remarks

Essa função falha com ERROR_ACCESS_DENIED se o arquivo de destino já exista e tenha a FILE_ATTRIBUTE_HIDDEN ou o atributo arquivo FILE_ATTRIBUTE_READONLY definido.

Se lpProgressRoutine Retorna PROGRESS_CANCEL porque o usuário cancela a operação, essa função retorna zero, e GetLastError Retorna ERROR_REQUEST_ABORTED. Neste maiúsculas e minúsculas, o arquivo de destino parcialmente copiados é excluído.

Se lpProgressRoutine Retorna PROGRESS_STOP porque o usuário pára a operação, essa função retorna zero, e GetLastError Retorna ERROR_REQUEST_ABORTED. Neste maiúsculas e minúsculas, o arquivo de destino parcialmente copiados é deixado intacto.

Requirements

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

See Also

Reference

File I/O Functions
CopyFile
CreateFile
MoveFile
DeleteAndRenameFile