Funzione OpenDesktopA (winuser.h)

Articolo
11/20/2024

Apre l'oggetto desktop specificato.

Sintassi

HDESK OpenDesktopA(
  [in] LPCSTR      lpszDesktop,
  [in] DWORD       dwFlags,
  [in] BOOL        fInherit,
  [in] ACCESS_MASK dwDesiredAccess
);

Parametri

[in] lpszDesktop

Nome del desktop da aprire. I nomi dei desktop non fanno distinzione tra maiuscole e minuscole.

Questo desktop deve appartenere alla stazione corrente della finestra.

[in] dwFlags

Questo parametro può essere zero o il valore seguente.

Valore	Significato
DF_ALLOWOTHERACCOUNTHOOK 0x0001	Consente ai processi in esecuzione in altri account sul desktop di impostare hook in questo processo.

[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 al desktop. Per un elenco dei diritti di accesso, vedere Desktop Security and Access Rights.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il desktop aperto. Al termine dell'uso dell'handle, chiamare la funzione CloseDesktop per chiuderla.

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

Osservazioni

Il processo chiamante deve avere una stazione finestra associata, assegnata dal sistema in fase di creazione del processo o impostata dalla funzione SetProcessWindowStation.

Se il parametro dwDesiredAccess specifica i diritti di accesso standard READ_CONTROL, WRITE_DACo WRITE_OWNER standard, è necessario richiedere anche i diritti di accesso DESKTOP_READOBJECTS e DESKTOP_WRITEOBJECTS.

Nota

L'intestazione winuser.h definisce OpenDesktop 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)