Funcion: FpRename()
Sintaxis:

function FpRename(
 
  old: pChar;
 
  newpath: pChar
 
):cInt;
 
function FpRename(
 
  old: A

Descripcion: renombra un archivo Old a el NewPath. NewPath puede ser un directorio diferente que Old, pero este no puede ser una particion diferente (device). Algun archivo existente sobre la nueva localizacion puede ser reemplazado.

Si la operacion falla, entonces archivo Old será preservado.

La funcion retorna cero cuando es ejecutada correctamente, y un valor diferente de cero cuando el valor indica un error.

ERRORES:
mas informacion puede ser obenida uasndo la funcion fpGetErrno.

sys_eisdir
NewPath existe y es un directorio, pero Old no es un directorio.
sys_exdev
NewPath y Old son diferentes particiones (devices).
sys_enotempty o sys_eexist
NewPath es directorio que no esta en blanco.
sys_ebusy
Old o NewPath son directorios y uno es en uso por otro proceso.
sys_einval
NewPath es parte de Old.
sys_emlink
OldPath o NewPath ya tienen la cantidad de links maxima apuntando a ellos.
sys_enotdir
Parte de Old o NewPath no es un directorio.
sys_efault
Para el caso de pchar: uno de los apuntadores a una direccion invalida.
sys_eaccess
acceso denegado cuando intentaste mover el archivo
sys_enametoolong
Cualquiera de Old o NewPath es demasiado largo.
sys_enoent
Un componente de directorio en Old o NewPath No existió.
sys_enomem
no hay suficiente memoria en el kernel.
sys_erofs
NewPath o Old esta sobre un archivo de sistema de solo lectura.
sys_eloop
Demasiados links simbolicos donde ha sido encontrados a expandir Old o NewPath
sys_enospc
El archivo de sistema no tiene tiene espacio para la nueva entrada en el directorio.

Vea tambien:
FpUnLink
Ejemplo:

No hay ejemplo disponible.