FUNCTIONUnder review

MSCopyFile

MsCopyFile(cArqOrig,cArqDest) -> lOk

Copies a binary file between paths.

MSCopyFileAdvPL

01 · OVERVIEW

Overview

Source and destination include filename and extension. Copying a file does not guarantee a consistent backup of a running database. Permissions and path-access context matter. Historical reference: verify behavior in the deployed release/RDD. (Sources: refs. 1–1.)

02 · SYNTAX

Syntax

MsCopyFile(cArqOrig,cArqDest) -> lOk

Parameters

cArqOrig

CharacterRequired

Source file path.

cArqDest

CharacterRequired

Destination file path.

Return value

Logical result of the documented operation.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function Ed534()
    // Block not invoked; supply only authorized test artifacts.
    Local bOperation := {|cSource,cDest| MsCopyFile(cSource,cDest)}
    ConOut(ValType(bOperation))
Return Nil

Expected result

Prints B. The operation is not executed; check its logical result when integrating. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

BEST PRACTICES

Check RDD, connection, path and destination ownership. Handle failures, collisions and open resources. This fragment is not a production backup or migration procedure.
Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.