Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

MSCopyTo

MsCopyTo([cArqOrig],cArqDest) -> lOk

Copia registros e estrutura para um destino.

MSCopyToAdvPL
01 · VISÃO GERAL

Visão geral

A origem omitida pode usar a área corrente no acesso local; no TOP precisa ser informada. O destino é obrigatório. Diferentemente de MsCopyFile, esta operação trata registros pelo driver. Referência histórica: confirmar comportamento no release/RDD utilizado. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

MsCopyTo([cArqOrig],cArqDest) -> lOk

Parâmetros

cArqOrig
CaractereOpcional

Origem; obrigatória no TOP.

cArqDest
CaractereObrigatório

Destino da cópia de registros.

Retorno

Lógico indicando o resultado da operação descrita.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed535()
    // Bloco nao invocado; fornecer somente artefatos de teste autorizados.
    Local bOperacao := {|cOrigem,cDestino| MsCopyTo(cOrigem,cDestino)}
    ConOut(ValType(bOperacao))
Return Nil
Resultado esperado

Imprime B. A operação não é executada; ao integrar, conferir o retorno lógico. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir RDD, conexão, caminho e propriedade do destino. Tratar falhas, colisões e recursos abertos. Não usar este fragmento como backup ou migração de produção.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. Waterloo Ferreira da Silva. AdvPL — O Manual, versão 1.0, p. 357. Referência histórica. Consulta em 2026-10-27.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha