Funzione OpenWindowStationA (winuser.h)

Articolo
08/27/2023

Apre la stazione della finestra specificata.

Sintassi

HWINSTA OpenWindowStationA(
  [in] LPCSTR      lpszWinSta,
  [in] BOOL        fInherit,
  [in] ACCESS_MASK dwDesiredAccess
);

Parametri

[in] lpszWinSta

Nome della stazione finestra da aprire. I nomi delle stazioni di finestra sono senza distinzione tra maiuscole e minuscole.

Questa stazione finestra deve appartenere alla sessione corrente.

[in] fInherit

Se questo valore è TRUE, i processi creati da questo processo erediteranno l'handle. In caso contrario, i processi non ereditano questo handle.

[in] dwDesiredAccess

Accesso alla stazione finestra. Per un elenco dei diritti di accesso, vedere Diritti di accesso e sicurezza della stazione di finestra.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'handle della stazione finestra specificata.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Al termine dell'handle, è necessario chiamare CloseWindowStation per liberare l'handle.

Nota

L'intestazione winuser.h definisce OpenWindowStation come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-windowstation-ansi-l1-1-1 (introdotta in Windows 10, versione 10.0.14393)