MoveFile

9/8/2008

Essa função renomeia uma arquivo existente ou um Diretório, incluindo todos os seus filhos. Uma versão RAPI dessa função existe chamado CeMoveFile (RAPI).

Syntax

BOOL MoveFile(
  LPCTSTR lpExistingFileName, 
  LPCTSTR lpNewFileName
); 

Parameters

• lpExistingFileName
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que nomeia uma arquivo existente ou Diretório.

• lpNewFileName
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que especifica o novo nome de um arquivo ou Diretório. O novo nome não deve já existe. Um novo arquivo pode estar em um sistema de arquivos diferentes ou unidade. Um novo Diretório deve estar na mesma unidade.

Return Value

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

Remarks

Essa função move ou renomeia um arquivo ou um Diretório, incluindo todos os seus filhos, tanto no Diretório mesmo ou em diretórios. Essa função falha na Diretório move quando o destino estiver em um volume diferente.

Observação

Um sem privilégios aplicativo pode usar esta função para mover ou renomear um Diretório que contém um arquivo sistema.Tal uma alteração efetivamente exclui o arquivo sistema porque ele não é encontrado na localidade esperada.Portanto, para proteger totalmente arquivos sistema, sua Diretório também deve ter o atributo sistema.

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.

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
CopyFile
DeleteAndRenameFile