Funzione OpenDesktopA (winuser.h)

Articolo
03/15/2023

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 sono senza distinzione tra maiuscole e minuscole.

Questo desktop deve appartenere alla stazione di finestra corrente.

[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 i 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 Sicurezza desktop e diritti di accesso.

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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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 dwDesiredAccessspecifica i diritti di accesso READ_CONTROL, WRITE_DAC o WRITE_OWNER diritti di accesso 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 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)