Función SwitchDesktop (winuser.h)

Hace que el escritorio especificado sea visible y lo activa. Esto permite al escritorio recibir la entrada del usuario. El proceso de llamada debe tener DESKTOP_SWITCHDESKTOP acceso al escritorio para que la función SwitchDesktop se realice correctamente.

Sintaxis

BOOL SwitchDesktop(
  [in] HDESK hDesktop
);

Parámetros

[in] hDesktop

Identificador del escritorio. Las funciones CreateDesktop y OpenDesktop devuelven este identificador.

Este escritorio debe estar asociado a la estación de ventana actual para el proceso.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError. Sin embargo, SwitchDesktop solo establece el último error para los casos siguientes:

• Cuando el escritorio pertenece a una estación de ventana invisible
• Cuando hDesktop es un identificador no válido, hace referencia a un escritorio destruido o pertenece a una sesión diferente a la del proceso de llamada.

Observaciones

Se produce un error en la función SwitchDesktop si el escritorio pertenece a una estación de ventana invisible. SwitchDesktop también produce un error cuando se llama desde un proceso asociado a un escritorio protegido, como los escritorios WinLogon y ScreenSaver. Los procesos asociados a un escritorio protegido incluyen procesos userInit personalizados. Normalmente, estas llamadas producen un error de "acceso denegado".

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-windowstation-l1-1-0 (introducido en Windows 8)

Consulte también

CreateDesktop

Escritorios

OpenDesktop

Funciones de escritorio y estación de ventanas