Función OpenInputDesktop (winuser.h)

Artículo
03/13/2024

Abre el escritorio que recibe la entrada del usuario.

Sintaxis

HDESK OpenInputDesktop(
  [in] DWORD       dwFlags,
  [in] BOOL        fInherit,
  [in] ACCESS_MASK dwDesiredAccess
);

Parámetros

[in] dwFlags

Este parámetro puede ser cero o el siguiente valor.

Valor	Significado
DF_ALLOWOTHERACCOUNTHOOK 0x0001	Permite que los procesos que se ejecutan en otras cuentas del escritorio establezcan enlaces en este proceso.

[in] fInherit

Si este valor es TRUE, los procesos creados por este proceso heredarán el identificador. De lo contrario, los procesos no heredan este identificador.

[in] dwDesiredAccess

Acceso al escritorio. Para obtener una lista de los derechos de acceso, consulte Derechos de acceso y seguridad de escritorio.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el escritorio que recibe la entrada del usuario. Cuando haya terminado de usar el identificador, llame a la función CloseDesktop para cerrarla.

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 proceso de llamada debe tener una estación de ventana asociada, ya sea asignada por el sistema cuando se crea el proceso o se establece mediante la función SetProcessWindowStation . La estación de ventana asociada al proceso de llamada debe ser capaz de recibir entradas.

Si el proceso de llamada se ejecuta en una sesión desconectada, la función devuelve un identificador al escritorio que se activa cuando el usuario restaura la conexión.

Una aplicación puede usar la función SwitchDesktop para cambiar el escritorio de entrada.

Si el parámetro dwDesiredAccess especifica los derechos de acceso estándar READ_CONTROL, WRITE_DAC o WRITE_OWNER , también debe solicitar los derechos de acceso DESKTOP_READOBJECTS y DESKTOP_WRITEOBJECTS .

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 (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-windowstation-l1-1-1 (introducido en Windows 8.1)