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

FTPDirectory

FTPDirectory(cMascara, [cAtributo]) --> aRet

Lista arquivos ou diretórios da sessão FTP.

FTPDirectoryAdvPL
01 · VISÃO GERAL

Visão geral

O manual histórico associa D a diretórios e omissão a arquivos. O exemplo oficial antigo descreve D de modo mais amplo; uma correção TOTVS posterior especifica o filtro somente de diretórios. Conferir a LIB e não extrapolar o layout completo do array a partir de uma posição usada no exemplo. O exemplo prepara um callback e não o executa. O chamador deve controlar a sessão FTP de teste e seus caminhos; não há servidor nem credenciais embutidos. (Fontes: refs. 1–3.)

02 · SINTAXE

Sintaxe

FTPDirectory(cMascara, [cAtributo]) --> aRet

Parâmetros

cMascara
CaractereObrigatório

Máscara remota.

cAtributo
CaractereOpcional

D para diretórios conforme manual/correção; conferir LIB.

Retorno

Array da listagem.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed399()
    Local bAcao := {|cMascara| FTPDirectory(cMascara)}
    // Nao avaliar: sessao e caminhos devem ser preparados pelo chamador.
Return Nil
Resultado esperado

Bloco preparado; nenhuma operação FTP realizada. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Validar permissões, retorno e propriedade da sessão. Encerrar a conexão que a rotina abriu inclusive nos caminhos de falha. Não registrar senhas.
  • 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. TOTVS. Exemplo de Funções FTP. TDN; referência de versões históricas. Consulta em 2026-10-26.
  2. Advpl o Manual, versão 1.0, pp. 341–347. Referência histórica; autoria não confirmada. Consulta em 2026-10-26.
  3. TOTVS. Correção FTPDirectory, chamado DFRM1-13114. TDN. Consulta em 2026-10-26.
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