TOTVSTEC

Árvore de páginas

Função: WriteProfString

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

Esta função é obsoleta, e pode ser removida em futuras versões de binário.


Sintaxe

WriteProfString ( < cSecao>, < cChave>, < cValor> ) --> lRet

Parâmetros/Elementos


NomeTipoDescriçãoObrigatórioReferência
cSecaoCaracterIndica o nome da seção que será criada ou alterada.X
cChaveCaracterIndica o nome da chave que será criada ou alterada.X
cValorCaracterIndica o conteúdo que será definido ou atualizado.X


Retorno
lRet
    (logico)
  • Retorna verdadeiro (.T.), se a chave for incluída ou alterada com sucesso, ou falso (.F.), caso ocorra alguma falha ou impossibilidade de acesso no arquivo de configuração.

Observações

  • O arquivo win.ini está disponível somente para sistemas operacionais Windows anteriores ao Windows XP, em modo de compatibilidade para aplicações 16 bits.
  •  Em ambiente Linux, será retornado o erro "cannot handle win.ini under unix systems".



Exemplo
User Function Exemplo()
	Local cSecao := "" 
	Local cChave := ""
	Local cValor := ""
	Local cRecuperado := ""
	Local cMensagem := ""
	
	//+----------------------------------------------------------------------------+
	//|Exemplifica o uso da função WriteProfString                                 |
	//+----------------------------------------------------------------------------+  
	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 com sucesso!"
		
		//+----------------------------------------------------------------------------+
		//|Apresenta uma mensagem com os resultados obtidos                            |
		//+----------------------------------------------------------------------------+
		
	MsgInfo(cMensagem, "Exemplo do WriteProfString")
Return


A partir de 09/09/2014 esta função é considerada obsoleta no Advpl, devido a não haver mais nenhuma versão de Windows homologada para o Totvs Application Server que faça uso deste arquivo de configuração ( win.ini )


Preview

Exemplo da função WriteProfString

Veja Também


  • Sem rótulos