Función CreateWindowStationA (winuser.h)
Crea un objeto de estación de ventana, lo asocia al proceso de llamada y lo asigna a la sesión actual.
Sintaxis
HWINSTA CreateWindowStationA(
[in, optional] LPCSTR lpwinsta,
DWORD dwFlags,
[in] ACCESS_MASK dwDesiredAccess,
[in, optional] LPSECURITY_ATTRIBUTES lpsa
);
Parámetros
[in, optional] lpwinsta
Nombre de la estación de ventana que se va a crear. Los nombres de las estaciones de ventana no distinguen mayúsculas de minúsculas y no pueden contener caracteres de barra diagonal inversa (\). Solo los miembros del grupo Administradores pueden especificar un nombre. Si lpwinsta es null o una cadena vacía, el sistema forma un nombre de estación de ventana con el identificador de sesión de inicio de sesión para el proceso de llamada. Para obtener este nombre, llame a la función
dwFlags
Si este parámetro es CWF_CREATE_ONLY y la estación de ventanas ya existe, se produce un error en la llamada. Si no se especifica esta marca y la estación de ventana ya existe, la función se realiza correctamente y devuelve un nuevo identificador a la estación de ventana existente.
Windows XP/2000: Este parámetro está reservado y debe ser cero.
[in] dwDesiredAccess
El tipo de acceso al identificador devuelto tiene que ir a la estación de ventanas. Además, puede especificar cualquiera de los derechos de acceso estándar, como READ_CONTROL o WRITE_DAC, y una combinación de los derechos de acceso específicos de la estación de ventana. Para obtener más información, vea Derechos de acceso y seguridad de la estación de ventanas.
[in, optional] lpsa
Puntero a una estructura de SECURITY_ATTRIBUTES que determina si los procesos secundarios pueden heredar el identificador devuelto. Si lpsa es null, no se puede heredar el identificador.
El miembro lpSecurityDescriptor de la estructura especifica un descriptor de seguridad para la nueva estación de ventanas. Si lpsa es null, la estación de ventana (y los escritorios creados en la ventana) obtiene un descriptor de seguridad que concede GENERIC_ALL acceso a todos los usuarios.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un identificador de la estación de ventana recién creada. Si la estación de ventana especificada ya existe, la función se realiza correctamente y devuelve un identificador a la estación de ventana existente.
Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.
Observaciones
Una vez que haya terminado con el controlador, debe llamar a CloseWindowStation para liberar el controlador.
Nota
El encabezado winuser.h define CreateWindowStation como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
winuser.h (incluya Windows.h) |
| biblioteca de |
User32.lib |
| DLL de |
User32.dll |
| conjunto de API de |
ext-ms-win-ntuser-windowstation-l1-1-0 (introducido en Windows 8) |
Consulte también
funciones de escritorio y estación de ventanas
estaciones de ventana de