GetGlbVars

Recupera o conteúdo de uma ou mais variáveis, armazenadas em uma variável global através da função PutGlbVars()

Sintaxe

GetGlbVars( < cGlbName >, < xValue1...N > )

Parâmetros

Retorno

Observações

• Variáveis globais são visíveis por todos os processos em execução dentro da instância de Application Server na qual elas foram criadas, mesmo entre ambientes / environments distintos. Isto significa que, caso não seja a intenção do desenvolvedor em compartilhar um conteúdo de variável global com outro ambiente, deve-se usar por exemplo o próprio nome do ambiente como parte do nome do identificador global a ser criado e/ou acessado.Enquanto houver pelo menos um processo em execução em uma instância de Application Server, as variáveis globais criadas nesta instância são mantidas na memória, e limpas apenas caso a aplicação assim o faça, explicitamente. Caso todos os processos AdvPl dessa instância sejam finalizados, na saída do último processo, todas as variáveis globais na memória serão limpas / eliiminadas.

Exemplos

User Function teste()
  // Alimenta valores das variáveis globais
  aGlbPut := {}
  aadd(aGlbPut,{"VarGlb01","Valor 01"})
  aadd(aGlbPut,{"VarGlb02","Valor 02"})
  aadd(aGlbPut,{"VarGlb03","Valor 03"})
  nValor := 123
  PutGlbVars("GlbNames",aGlbPut,nValor)
  // Retorna os valores das variáveis globais
  nValRet := 0
  aGlbRet := {}
  GetGlbVars("GlbNames",<at:var at:name="aGlbRet," />nValRet)
Return

Abrangência

Microsiga Protheus 8.11 , Protheus 10, Protheus 11

Veja também

• ClearGlbValue
• GetGlbValue
• PutGlbValue
• PutGlbVars