TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 2

changes.mady.by.user admin

Gravado em

comparado com

Nova versão 3

changes.mady.by.user Rafaela Rocha Hikiji

Gravado em

Chave

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

...

Portuguese

Pagetitle
GetProfString
GetProfString

Função: GetProfString

Recupera o conteúdo caractere de uma chave do arquivo win.ini (arquivo utilizado para armazenar configurações básicas de inicialização) do sistema operacional.

Sintaxe

GetProfString ( < cSecao>, < cChave>, < cPadrao> ) --> cRet

Parâmetros/Elementos
NomeTipoDescriçãoObrigatórioReferência
cSecaoCaracterIndica o nome da seção em que um valor será recuperado. X
cChaveCaracterIndica o nome da chave em que um valor será recuperado. X
cPadraoCaracterIndica o conteúdo padrão que será recuperado. X
Retorno
    cRet(caracter)
  • Retorna o conteúdo da chave especificada ou o seu valor padrão.
Observações
  • O arquivo win.ini está disponível somente para sistemas operacionais Windows.
  • Em ambiente Linux, será retornado o erro "cannot handle win.ini under unix systems".


Exemplos 
User Function Exemplo()Local cSecao := "", cChave := "", cValor := "", cRecuperado := "", cMensagem := ""//+----------------------------------------------------------------------------+//|Exemplifica o uso da função GetProfString                                   |//+----------------------------------------------------------------------------+  cSecao := "SecaoExemplo"  cChave := "ChaveExemplo"  cValor := "ConteudoExemplo"  WriteProfString(cSecao, cChave, cValor)  cRecuperado := GetProfString(cSecao, cChave, "undefined")  cMensagem += "Seção [" + cSecao + "], chave [" + cChave + ;    "] e conteúdo [" + cValor + "] " + ;    IIf(!(cRecuperado == cValor), "não ", " ") + "gravado e recuperado com sucesso!"//+----------------------------------------------------------------------------+//|Apresenta uma mensagem com os resultados obtidos                            |//+----------------------------------------------------------------------------+Return MsgInfo(cMensagem, "Exemplo do GetProfString")

Preview
Exemplo da função GetProfString
Abrangência
Microsiga Protheus 8.11 , Protheus 10
Veja Também
Manipulação do arquivo de configuração (*.INI)