Funzione OpenDesktopA (winuser.h)
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 |
|---|---|
|
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) |