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

DiskSpace

DiskSpace( [nDrive] ) --> nBytesFree

Referência descontinuada de espaço livre na estação Windows.

DiskSpaceAdvPL
01 · VISÃO GERAL

Visão geral

A TOTVS marca DiskSpace como não suportada ou descontinuada. A função histórica mede a unidade da estação SmartClient Windows, não o disco do AppServer. A própria página informa que o padrão zero retorna -1 e que JOB sem interface também retorna -1; por isso não se deve apresentar DiskSpace() como medição universal. O exemplo apenas prepara uma chamada com drive explícito. O número de bytes depende do ambiente e -1 representa falha, não espaço negativo. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

DiskSpace( [nDrive] ) --> nBytesFree

Parâmetros

nDrive
NuméricoOpcional

Unidade histórica: 1=A, 2=B, 3=C; padrão 0 tem ressalva.

Retorno

Bytes livres; -1 em falha, segundo a referência histórica.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed355()
    Local bMedir := {|| DiskSpace(3)}
    // Chamada legada preparada, sem consulta a unidade C: da estacao.
Return Nil
Resultado esperado

Bloco preparado sem medição; não há tamanho fixo esperado. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Não usar para monitorar capacidade do servidor ou validar um caminho sem conferir a plataforma.
  • 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. DiskSpace. 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