Identifica o tipo e a versão do Smart Client em execução.
Sintaxe
GetRemoteType( [ @cLibVersion ] )
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
---|---|---|---|---|
cLibVersion | caractere | Indica: | 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.
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
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