TOTVSTEC

Árvore de páginas

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 > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cSecao

caractere

Indica o nome da seção em que um valor será recuperado.

X


cChave

caractere

Indica o nome da chave em que um valor será recuperado.

X


cPadrao

caractere

Indica o conteúdo padrão que será recuperado.

X


Retorno

Nome

Tipo

Descrição

cRet

caractere

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")

Veja também



  • Sem rótulos