Função GetConsoleWindow

  • Artigo

Importante

Este documento descreve a funcionalidade da plataforma de console que não faz mais parte do nosso roteiro do ecossistema. Não recomendamos o uso desse conteúdo em novos produtos, mas continuaremos a oferecer suporte aos usos existentes por tempo indeterminado. Nossa solução moderna preferida se concentra em sequências de terminais virtuais para máxima compatibilidade em cenários de multiplataforma. Você pode encontrar mais informações sobre essa decisão de design em nosso documento Console clássico versus terminal virtual.

Recupera o identificador de janela usado pelo console associado ao processo de chamada.

Sintaxe

HWND WINAPI GetConsoleWindow(void);

Parâmetros

Essa função não tem parâmetros.

Valor retornado

O valor retornado é um identificador para a janela usada pelo console associado ao processo de chamada ou NULL na ausência de console associado.

Comentários

Para compilar aplicativos que usam essa função, defina _WIN32_WINNT como 0x0500 ou posterior. Para obter mais informações, consulte Usar os cabeçalhos do Windows.

Dica

Essa API não é recomendada e não tem um terminal virtual equivalente. Essa decisão alinha propositalmente a plataforma Windows com outros sistemas operacionais. Esse estado é relevante somente para o contexto de usuário, sessão e privilégio locais. A comunicação remota de aplicativos por meio de utilitários multiplataforma e transportes como SSH pode não funcionar como esperado se essa API é usada.

Para aplicativos hospedados em uma sessão de pseudoconsole, essa função retorna um identificador de janela somente para propósitos de fila de mensagens. A janela associada não é exibida localmente, pois o pseudoconsole está serializando todas as ações em um fluxo para apresentação em outra janela de terminal em outro local.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho ConsoleApi3.h (via WinCon.h, inclui o Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções de Console