FUNCIóNEn revisión

MSRename

MsRename(cArqOrig,cArqDest) -> lOk

Renombra archivo según RDD actual.

MSRenameAdvPL

01 · DESCRIPCIÓN GENERAL

Descripción general

Referencia histórica recibe origen/destino con nombre/extensión y retorna éxito lógico. No renombra alias abierto ni nombre lógico del diccionario. Rutas/restricciones dependen de RDD y ambiente. Documentación histórica no demuestra soporte irrestricto para renombrar tablas en todo SGBD. (Fuentes: refs. 1–1.)

02 · SINTAXIS

Sintaxis

MsRename(cArqOrig,cArqDest) -> lOk

Parámetros

cArqOrig

CarácterObligatorio

Archivo origen con extensión.

cArqDest

CarácterObligatorio

Nuevo nombre con extensión.

Retorno

Lógico: .T. si operación tiene éxito.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed550()
    // Bloque no invocado; usar archivos de prueba propios y cerrados.
    Local bRenombrar := {|cOrigen,cDestino| MsRename(cOrigen,cDestino)}
    ConOut(ValType(bRenombrar))
Return Nil

Resultado esperado

Imprime B. No ejecuta cambio de nombre. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS

Comprobar origen, destino libre, permisos, RDD e índices antes de evaluar. Tratar fallo sin asumir creación de destino.
En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS

Waterloo Ferreira da Silva. AdvPL — O Manual, versão 1.0, p. 360. Referência histórica. Consulta el 2026-10-27.

Estado: En revisión
Página creada el: 27/10/2026 a las 16:02
Última revisión el: 27/10/2026 a las 16:02
Idioma original: Portugués
Revisión: Usina.BR