Condividi tramite


Funzione OpenWindowStationA (winuser.h)

Apre la stazione 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 finestra non fanno 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 della finestra. Per un elenco dei diritti di accesso, vedere Window Station Security and Access Rights.For a list of access rights, see Window Station Security and Access Rights.

Valore restituito

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

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

Osservazioni

Al termine dell'handle, devi 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 indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione winuser.h (include Windows.h)
libreria User32.lib
dll User32.dll
set di API ext-ms-win-ntuser-windowstation-ansi-l1-1-1 (introdotto in Windows 10, versione 10.0.14393)

Vedere anche

CloseWindowStation

ExitWindows

ExitWindowsEx

funzioni di windows e desktop