Funzione OpenProcess (processthreadsapi.h)

Articolo
08/25/2023

Apre un oggetto processo locale esistente.

Sintassi

HANDLE OpenProcess(
  [in] DWORD dwDesiredAccess,
  [in] BOOL  bInheritHandle,
  [in] DWORD dwProcessId
);

Parametri

[in] dwDesiredAccess

Accesso all'oggetto processo. Questo diritto di accesso viene controllato rispetto al descrittore di sicurezza per il processo. Questo parametro può essere uno o più dei diritti di accesso del processo.

Se il chiamante ha abilitato il privilegio SeDebugPrivilege, l'accesso richiesto viene concesso indipendentemente dal contenuto del descrittore di sicurezza.

[in] bInheritHandle

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

[in] dwProcessId

Identificatore del processo locale da aprire.

Se il processo specificato è il processo di inattività del sistema (0x00000000), la funzione ha esito negativo e l'ultimo codice di errore è ERROR_INVALID_PARAMETER. Se il processo specificato è il processo di sistema o uno dei processi client server Run-Time Subsystem (CSRSS), questa funzione ha esito negativo e l'ultimo codice di errore è ERROR_ACCESS_DENIED dovuto al fatto che le restrizioni di accesso impediscono l'apertura del codice a livello di utente.

Se si usa GetCurrentProcessId come argomento per questa funzione, è consigliabile usare GetCurrentProcess anziché OpenProcess per migliorare le prestazioni.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle aperto per il processo specificato.

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

Commenti

Per aprire un handle a un altro processo locale e ottenere diritti di accesso completi, è necessario abilitare il privilegio SeDebugPrivilege. Per altre informazioni, vedere Modifica dei privilegi in un token.

L'handle restituito dalla funzione OpenProcess può essere usato in qualsiasi funzione che richiede un handle per un processo, ad esempio le funzioni di attesa, purché siano stati richiesti i diritti di accesso appropriati.

Al termine dell'handle, assicurarsi di chiuderlo usando la funzione CloseHandle .

Esempio

Per un esempio, vedere Acquisizione di uno snapshot e visualizzazione di processi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	processthreadsapi.h (include Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria	Kernel32.lib
DLL	Kernel32.dll