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.dllAssinatura
BOOL CopyFileW(
LPCWSTR lpExistingFileName,
LPCWSTR lpNewFileName,
BOOL bFailIfExists
);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| lpExistingFileName | LPCWSTR | Caminho do arquivo de origem. |
| lpNewFileName | LPCWSTR | Caminho do arquivo de destino. |
| bFailIfExists | BOOL | Se 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.