Histórico da Página

...

Portuguese

Pagetitle

	GetRemoteType
	GetRemoteType

Identifica o tipo e a versão do Smart Client em execução.

Sintaxe

Bloco de código

collapse	false

GetRemoteType( [ @cLibVersion ] )

Parâmetros

Nome	Tipo	Descrição	Obrigatório	Referência
cLibVersion	caractere	Indica a : A versão da biblioteca gráfica do Smart Client., se utilizado o Smart Client Desktop OU A versão do WebApp, se utilizado via navegador		X

Retorno

Nome	Tipo	Descrição
nRet	numérico	Retorna o número correspondente ao sistema operacional, em uso, que o Smart Client está sendo executado. Sendo: -1 = Job, Web ou Working Thread (Sem remote); 1 = Ambiente Microsoft Windows ou 2 = Ambiente Linux/Unix.

Observações

Função disponível a partir da build 7.00.040308A.

Em versões superiores à 120420A foi implementado o retorno do sistema operacional a partir do parâmetro cLibVersion (por referência). Esta característica foi implementada devido aos sistemas operacionais Linux e MacOS retornarem o mesmo código, pois ambos são Unix. Com a nova implementação teremos os seguintes retornos:

WIN=Windows

LINUX=Linux

MAC=MacOS

Tipos de Retorno -1 = A execução do programa não utiliza o Smart Client, geralmente é um JOB.

0 = Smart Client das versões 6 e 7 em ambiente Windows.

1 = Smart Client das verões 8 e 10 em ambiente Windows (*).

2 = Smart Client das verões 8 e 10 em ambiente Linux /MacOS (*).

3 = Não utilizado.

4 = Sessão TELNET do módulo 4GL.

5 = Smart Client versão HTML.

6 = Não utilizado.

7 = TOTVS Smart Client versão Windows CE (experimental, não homologado)

(*) A partir dos builds superiores a 7.00.080806P - Oct 2 2008 - 11:47:14, pode-se passar parâmetro por referência para obter a versão da biblioteca gráfica em uso pelo Smart Client.

Nota

title	Informações importantes

🚨 A partir da Release 12.1.22.10, utilizando o WebAgent e o ERP via navegador, o retorno da função GetRemoteType terá o sequinte comportamento:

O retorno da função será o mesmo do SmartClient Desktop, exemplo: 1=Windows / 2=Linux/MacOS.
O parâmetro passado por referência cLibVersion, retornará a versão do WebApp, exemplo: "HTML-9.0.0 LINUX"

Exemplos

Bloco de código

language	cpp
theme	Eclipse
linenumbers	true
collapse	false

user function exemplo()
  Local cLib
  QOut(GetRemoteType(@cLib)) // -> 1 se executar TOTVS SmartClient em versão Windows
  QOut(cLib) // -> "QT-4.5.2 WIN" -> Retorno do SO implementado em versões superiores a 120420A
return

// Utilizando o WebApp com o WebAgent é possivel verificar a execução via WebApp capturando a informação adcional por referência
function u_remoteType()
  Local cLib
  Local cRmtType := GetRemoteType(@cLib) 
  conout("Tipo do remote: " + cValToChar(cRmtType)) // -> Ex: 1=Windows | 2=Linux/MacOS
  conout("Info adicional: " + cLib)                 // -> Exemplo ao utilizar o WebApp: "HTML-9.1.6 LINUX"
return

// Retorno
// Tipo do remote: 2
// Info adicional: HTML-9.1.6 LINUX

Abrangência

Microsiga Protheus 8.11 , TOTVS Application Server 10 , ByYou Application Server

...

Árvore de páginas

Versões comparadas

Versão antiga 14

Nova versão 15

Chave