Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Inclusão de trecho
advpl - deprecated
advpl - deprecated
nopaneltrue

Composition Setup
import.css=/download/attachments/

...

6062824/

...

tecnologia.css

...


Pagetitle

...

DiskSpace

...

...

DiskSpace

Retorna

...

o

...

número

...

de

...

bytes

...

que

...

estão

...

disponíveis

...

em

...

uma

...

determinada

...

unidade

...

de

...

disco

...

da

...

estação

...

remota.

Sintaxe

Bloco de código
collapsefalse
DiskSpace( [ nDrive ] )

...


Parâmetros

...

Nome

Tipo

Descrição

Obrigatório

Referência

nDrive

...

numérico

Indica o número da unidade de disco (drive). Sendo: 0=Unidade de disco atual da estação (Padrão), 1=Drive A: da estação remota, 2=Drive B da estação remota, 3=Drive C: da estação remota, 4=Drive D: da estação remota e etc.

 

 

 

Retorno

Nome

Tipo

Descrição

...

nBytesFree

...

numérico

...

Retorna o número de bytes que estão disponíveis na unidade de disco.

...

<br>Em caso de erro, retorna -1.

Observações

  • Esta função obtém a informação sempre relativa à estação em que o Smart Client está sendo executado.
  • A função funciona somente na versão Windows do SmartClient.
  • Caso essa função seja executada através de JOB (Processo isolado no servidor, sem interface remota), ou seja, passado um parâmetro de unidade de disco inexistente ou indisponível, o retorno será -1.
  • O parâmetro

...

  • <nDrive> passado com 0 (opção padrão) nunca foi considerado, logo, retorna -1.

Exemplos

Bloco de código
languagecpp
themeEclipse
titleExemplo 1
linenumberstrue
collapsefalse
User Function Exemplo()
  // Retorna o tamanho em bytes do HD
  nRet := DISKSPACE( 3 ) // Resultado: 1356947456  
Return

User Function Exemplo2()
  // No exemplo abaixo, obtemos os espaços em disco do drive A:
  // da estação local, verificando se houve sucesso na operação.
  
  nBytes_A := DISKSPACE( 1 ) // Retorna o espaço disponivel no drive A: local ( remote ).
  
  If nBytes_A == -1
   MsgStop('Unidade A: não está disponível ou não há disco no Drive')
  ElseIf nBytes_A < 8192
   MsgStop('Não há espaço disponível no disco. Substitua o disco na Unidade A:')
  Else
   MsgStop('Unidade A: Verificada . '+str(nBytes_A,12)+' bytes livres.')
  Endif
Return

Abrangência

Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server

...