TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 3

changes.mady.by.user Rafaela Rocha Hikiji

Gravado em

comparado com

Nova versão 4

changes.mady.by.user Rogerio Ribeiro da Cruz

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.

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.
  •  Em ambiente Linux, será retornado o erro "cannot handle win.ini under unix systems".

 

 

Bloco de código
themeEclipse
languagecpp
titleExemplo
linenumberstrue
Exemplos 
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                            |
		//+----------------------------------------------------------------------------+
Return 

		
	MsgInfo(cMensagem, "Exemplo do WriteProfString")
Return

 

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