Voltar à lista
Windows Win32Arquivos & E/Skernel32.dll

CopyFileW

Copia um arquivo para um novo caminho, preservando atributos básicos.

Descrição

Operação implementada em espaço de usuário (não uma única syscall atômica no kernel), mas otimizada internamente pelo sistema.

Header: winbase.hDLL: kernel32.dll

Assinatura

BOOL CopyFileW(
    LPCWSTR lpExistingFileName,
    LPCWSTR lpNewFileName,
    BOOL bFailIfExists
);

Parâmetros

ParâmetroTipoDescrição
lpExistingFileNameLPCWSTRCaminho do arquivo de origem.
lpNewFileNameLPCWSTRCaminho do arquivo de destino.
bFailIfExistsBOOLSe TRUE, falha caso o destino já exista.

Valor de retorno

Diferente de zero em sucesso; 0 em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_FILE_NOT_FOUND(2)
O sistema não conseguiu encontrar o arquivo especificado.
ERROR_ALREADY_EXISTS(183)
Não é possível criar um arquivo já existente.
ERROR_ACCESS_DENIED(5)
Acesso negado.

Relacionadas