TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 5

changes.mady.by.user Julio Wittwer

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Oberdan de Almeida Santos

Gravado em

Chave

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

...

Portuguese

Pagetitle
WriteProfString
WriteProfString

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



Bloco de código
 code
language
cpp
themeEclipse
languagecpp
titleExemplo
linenumberstrue
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
Abrangência
Microsiga Protheus 8.11 , Protheus 10
Veja Também
Manipulação do arquivo  (*.INI)