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) |