Solução de problemas

Last published : Nov 13, 2026
Related information
Seamless

Solução de problemas de encerramento de sessão com Aplicativos Publicados

Ao publicar aplicativos, apenas o arquivo executável principal do aplicativo publicado é especificado. No entanto, alguns aplicativos podem produzir processos adicionais (filhos) que são executados em segundo plano e não são fechados pelo arquivo executável principal correspondente quando o aplicativo publicado principal é fechado. Processos adicionais também podem ser criados a partir de scripts executados ou de chaves de registro específicas, como Run e RunOnceKey. Esses aplicativos podem impedir um encerramento de sessão adequado, resultando em sessões persistentes ou travadas e podem fazer com que a sessão não seja fechada e o usuário seja desconectado.
Nesse caso, você precisa redefinir ou encerrar essas sessões usando o Citrix Director.
Para ajudar a identificar e solucionar problemas de sessões que não estão sendo encerradas corretamente, a Citrix disponibilizou três entradas de registro. A identificação e solução de problemas de sessões que não estão sendo desconectadas corretamente devido a esses problemas é um processo de três etapas:
  1. Identificar quais sessões com aplicativos publicados estão impedindo um encerramento de sessão adequado
  2. Identificar para esses aplicativos publicados se eles produzem quaisquer processos adicionais (filhos)
  3. Adicionar esses processos a uma entrada de registro especificada para evitar que eles impeçam o encerramento da sessão

Passo 2: Identificar se essas aplicações publicadas produzem quaisquer processos adicionais (filhos)

Uma vez que uma aplicação publicada é identificada como impedindo um logoff gracioso, o próximo passo é determinar se esta aplicação produz processos adicionais quando em execução.
Você pode ler HKCU\Software\CitrixVolatile\Seamless\Sessions\[ID]\LogoffCheckerBlockingProcess para determinar se algum processo está bloqueando um logoff gracioso quando uma aplicação publicada é fechada.
No exemplo a seguir, a chave LogoffCheckerBlockingProcess contém as seguintes entradas:
PhoneExperienceHost.exe
SkypeApp.exe
SkypeBackgroundHost.exe
Esses processos impediram o logoff gracioso.
Observação:
Substitua o pelo ID de sessão correto para a sessão que você deseja verificar.

Passo 3: Adicionar esses processos a uma entrada de registro especificada para evitar que eles impeçam o logoff

Você pode adicionar esses processos às seguintes chaves de registro para evitar que eles atrasem o logoff em sessões futuras:
Add the process file name to the following registry key:
Caution! Refer to the Disclaimer at the end of this article before using the Registry Editor.
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI
Value Name:LogoffCheckSysModules
Type:REG_SZ
String:MyAppName.exe
Para mais informações sobre LogoffCheckSysModules, consulte Logoff gracioso de uma aplicação publicada deixa a sessão em estado ativo.

Guia de solução de problemas passo a passo

  1. Inicie o serviço de registro remoto no VDA em teste:
    1. No Painel de Controle, selecione Ferramentas Administrativas > Serviços.
    2. Clique com o botão direito do mouse em Serviço de Registro Remoto e selecione Propriedades.
    3. Em Tipo de Inicialização, selecione Automático no menu suspenso.
    Registro de aplicativo publicado
  2. Desative o Firewall do Windows no VDA em teste ou crie uma regra de firewall de entrada para habilitar a porta 455:
    1. No Painel de Controle, selecione Firewall do Windows Defender > Configurações Avançadas.
    2. Clique com o botão direito do mouse em Regras de Entrada e selecione Nova Regra.
    3. No Assistente de Nova Regra de Entrada, selecione Porta.
    4. Na página Protocolos e Portas, selecione TCP e Portas Locais Específicas. Insira 445 como a porta local.
    5. Selecione Permitir Conexão na página Ação.
    6. Selecione os perfis de firewall aos quais você deseja aplicar a nova regra de entrada.
    7. Nomeie a regra de firewall e selecione Concluir para sair do Assistente de Nova Regra de Entrada.
      Porta do firewall do aplicativo publicado
  3. De outra VM no mesmo domínio (pode ser DC, DDC ou outro VDA), execute Regedit e conecte-se a um registro remoto.
    Editor de registro do aplicativo publicado
  4. Insira o endereço IP do VDA em teste e clique em OK. A árvore regedit deve exibir ramificações para o VDA em teste.
    Regedit do aplicativo publicado
  5. Abra o aplicativo publicado Prompt de Comando.
    Gerenciar aplicativo publicado
    O aplicativo Prompt de Comando é exibido no Citrix Workspace.
    Aplicativo publicado prompt de comando
  6. Abra o Centro de Conexão no cliente. Isso é usado para monitorar quando uma sessão é encerrada, após fechar um aplicativo contínuo aberto. Podemos ver na imagem a seguir que o processo do Prompt de Comando c:\Windows\system32\cmd.exe está ativo no VDI remoto.
    Conexão do aplicativo publicado
  7. No VDA onde o regedit está em execução, vá para o seguinte local de IP remoto: HKEY_USERS\S-1-X-XX-XXXXXXXX-XXXXXXXXXXX-XXXXXXXXXX-XXXX\SOFTWARE\CitrixVolatile\Seamless\Sessions\X\
    Observação:
    Este caminho muda toda vez que você abre uma nova sessão.
  8. Há duas chaves para ler aqui (não as altere aqui): LogoffCheckBlockingProcess e LogoffCheckerBlockingVisibleProcess. Essas chaves exibem quaisquer programas que estejam bloqueando o logoff. A primeira deve exibir C:\Windows\System32\cmd.exe, pois estava aberta e ainda não foi fechada.
    Observação:
    LogoffCheckBlockingProcess e LogoffCheckerBlockingVisibleProcess não devem ser editados manualmente. A edição manual desses valores de registro pode levar a sessões instáveis.
    Aplicativo publicado 2
  9. Clique em X no canto superior direito para sair do CMD Contínuo.
  10. Verifique o centro de conexão para ver se a sessão é encerrada. Pode levar até 30 segundos para fechar. Se fechar, não houve aplicativos ou processos que impediram um logoff normal.
    Logoff normal
  11. Se a sessão não fechou, atualize a saída do regedit com F5.
  12. Verifique novamente o conteúdo de LogoffCheckBlockingProcess e LogoffCheckerBlockingVisibleProcess. O CMD não deve mais estar presente, mas deve haver outro processo listado. Qualquer processo que esteja atualmente bloqueando o logoff da sessão deve ser exibido aqui.
    Neste caso, o Notepad.exe está aberto a partir do prompt de comando publicado antes que o prompt de comando fosse fechado, e este processo remoto do Notepad está impedindo um logoff normal.
    Regedit
  13. Anote o caminho para este executável e em qual chave ele apareceu, e insira-o na seguinte chave de registro, sob a árvore remota:
    • Se aparecer em LogoffCheckBlockingProcess: HKLM\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWILogoffCheckSysModulesInternal
    • Se aparecer em LogoffCheckerBlockingVisibleProcess: HKLM\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWILogoffCheckVisibleSysModules
    Observação:
    Se já houver uma ou mais entradas na chave, adicione uma vírgula ao final e coloque a nova entrada após a vírgula.
    Regedit-final
  14. Saia da sessão do centro de conexão no cliente e reabra o Aplicativo Remoto.
  15. Repita os passos 9-16 até que a sessão seja encerrada automaticamente dentro de 30 segundos após fechar o Aplicativo Remoto.
    Observação:
    Após a solução de problemas, reverta as alterações temporárias do Firewall para permitir o acesso remoto ao registro, se necessário.

Como modificar o LogonUI para visualizar a mensagem de isenção de responsabilidade do Windows em tamanho real ao abrir aplicativos publicados

O escalonamento da janela LogonUI é aprimorado para cenários onde a autenticação pass-through não ocorre. A janela LogonUI é escalonada com base na resolução do monitor e nas configurações de DPI usadas, o que garante que a janela LogonUI completa seja visível sem nenhum corte.
O tamanho da janela em pixels também pode ser definido manualmente no registro.
  1. Abra o Editor do Registro usando regedit no comando Executar.
  2. Vá para HKEY_LOCAL_MACHINE\Software\Citrix\CtxHook\AppInit_DLLS\Seamless Hook\.
  3. Crie duas novas chaves DWORD: LogonUIWidth e LogonUIHeight.
  4. Defina o valor das chaves para a largura e altura necessárias em pixels para a janela LogonUI.
    Ao definir manualmente o tamanho da janela LogonUI, o dimensionamento automático é desativado.
Observação:
Esses caminhos de registro foram alterados a partir da versão 2407 e posteriores. Os valores de registro antigos são ignorados e descontinuados.
Por padrão, a janela LogonUI inclui uma barra de título com um botão de fechar que permite ao usuário final desconectar-se da sessão, se necessário.

Desativar uma barra de título

Você pode desativar a barra de título na janela LogonUI com a seguinte chave de registro:
  1. Abra o Editor do Registro usando regedit no comando Executar.
  2. Vá para HKEY_LOCAL_MACHINE\Software\Citrix\CtxHook\AppInit_DLLS\Seamless Hook\.
  3. Crie novas chaves DWORD: LogonUICaption e defina o valor da chave como 0.
    Janela LogonUI com barra de título

Aplicativo publicado não aparece

Consulte os artigos de suporte para solucionar problemas em casos em que o aplicativo publicado não inicia ou desaparece durante o lançamento ou quando ele falha ao aparecer.
Para solucionar problemas em casos

Configurações adicionais de configuração Seamless

Na maioria das circunstâncias, as configurações padrão do servidor são suficientes para a maioria dos aplicativos, e nenhuma configuração adicional é necessária para aplicativos publicados.
Em alguns casos, é necessária uma configuração adicional, incluindo o controle da interação e exibição de janelas de aplicativos especificadas, bem como configurações dentro do próprio ambiente do aplicativo publicado.
Observação:
A Citrix não recomenda alterar essas configurações, a menos que explicitamente instruído pelo suporte da Citrix.
Essas configurações são descritas no artigo da KB sobre configurações Seamless.