Compartilhar via

Função SwitchDesktop (winuser.h)

  • Artigo

Torna a área de trabalho especificada visível e a ativa. Isso permite que a área de trabalho receba a entrada do usuário. O processo de chamada deve ter DESKTOP_SWITCHDESKTOP acesso à área de trabalho para que a função SwitchDesktop tenha êxito.

Sintaxe

BOOL SwitchDesktop(
  [in] HDESK hDesktop
);

Parâmetros

[in] hDesktop

Um identificador para a área de trabalho. Esse identificador é retornado pelas funções CreateDesktop e OpenDesktop .

Essa área de trabalho deve ser associada à estação de janela atual para o processo.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. No entanto, SwitchDesktop define apenas o último erro para os seguintes casos:

  • Quando a área de trabalho pertence a uma estação de janela invisível
  • Quando hDesktop é um identificador inválido, refere-se a uma área de trabalho destruída ou pertence a uma sessão diferente da do processo de chamada

Comentários

A função SwitchDesktop falhará se a área de trabalho pertencer a uma estação de janela invisível. SwitchDesktop também falha quando chamado de um processo associado a uma área de trabalho protegida, como as áreas de trabalho WinLogon e ScreenSaver. Os processos associados a uma área de trabalho protegida incluem processos UserInit personalizados. Essas chamadas normalmente falham com um erro de "acesso negado".

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]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-windowstation-l1-1-0 (introduzido no Windows 8)

Confira também

CreateDesktop

Desktops

OpenDesktop

Funções estação de janela e área de trabalho