Función GetThreadDesktop (winuser.h)
Recupera un identificador al escritorio asignado al subproceso especificado.
Sintaxis
HDESK GetThreadDesktop(
[in] DWORD dwThreadId
);
Parámetros
[in] dwThreadId
Identificador de subproceso. Las funciones GetCurrentThreadId y CreateProcess devuelven identificadores de subproceso.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un identificador del escritorio asociado al subproceso especificado. No es necesario llamar a la función CloseDesktop para cerrar el identificador devuelto.
Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.
Comentarios
El sistema asocia un escritorio a un subproceso cuando se crea ese subproceso. Un subproceso puede usar la función SetThreadDesktop para cambiar su escritorio. El escritorio asociado a un subproceso debe estar en la estación de ventana asociada al proceso del subproceso.
El proceso de llamada puede usar el identificador devuelto en las llamadas a las funciones GetUserObjectInformation, GetUserObjectSecurity, SetUserObjectInformation y SetUserObjectSecurity .
Se crea una aplicación de servicio con una estación de ventana y un escritorio asociados, por lo que no es necesario llamar a una función USER o GDI para conectar el servicio a una estación de ventana y escritorio.
Requisitos
| Requisito | Value |
|---|---|
| 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) |