WritePProString

Função: WritePProString

Permite criar e/ou alterar um seção/chave de configuração no arquivo de configuração (.INI). No entanto, caso o arquivo não exista ele será criado.

Pode-se, opcionalmente, definir um path absoluto, com unidade de disco, de modo que o arquivo de configuração (.INI) será atualizado na estação onde o TOTVS Smart Client está sendo executado.

Sintaxe

WritePProString ( < cSecao>, < cChave>, < cConteudo>, < cArqIni> ) --> lRet

Parâmetros/Elementos

Nome	Tipo	Descrição	Obrigatório	Referência
cSecao	Caracter	Indica o nome da seção, no arquivo de configuração (.INI), que será utilizada. Porém, caso a seção não exista, a mesma será criada.	X
cChave	Caracter	Indica o nome da chave da seção, do arquivo de configuração (.INI), que terá seu conteúdo alterado. Porém, caso a chave não exista na seção especificada, a mesma será criada.	X
cConteudo	Caracter	Indica o conteúdo da chave que será atualizado.	X
cArqIni	Caracter	Indica o nome do arquivo de configuração (.INI) que será alterado. Porém, é importante observar os seguintes casos: Se o arquivo de configuração (.INI) não existir, o mesmo será criado; Se o path do arquivo de configuração (.INI) não for informado, o mesmo será criado/atualizado no diretório onde está instalado TOTVS Application Server, no servidor; Se especificado um path absoluto, com unidade de disco, o arquivo de configuração (.INI) será criado e/ou atualizado na estação remota, no path informado.	X
lRet	logico	Retorna verdadeiro (.T.) se a chave for incluída e/ou alterada com sucesso ou falso (.F.) caso ocorra alguma falha ou impossibilidade de acesso no arquivo de configuração (.INI).

Observações

As causas mais comuns de falha, no retorno da função, ocorre por erro de sintaxe no nome do arquivo e/ou path inexistente ou inacessível.

Exemplos

WritePProString('PALMJOB', 'Main', 'PalmJob', "TOTVSAPPSERVER.INI")

Veja Também

Application Server - Arquivo de configuração

Árvore de páginas