Funzione OpenThread (processthreadsapi.h)

Articolo
03/01/2024

Apre un oggetto thread esistente.

Sintassi

HANDLE OpenThread(
  [in] DWORD dwDesiredAccess,
  [in] BOOL  bInheritHandle,
  [in] DWORD dwThreadId
);

Parametri

[in] dwDesiredAccess

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

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] dwThreadId

Identificatore del thread da aprire.

Valore restituito

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

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

Commenti

L'handle restituito da OpenThread può essere usato in qualsiasi funzione che richiede un handle a un thread, ad esempio le funzioni di attesa, a condizione che siano stati richiesti i diritti di accesso appropriati. L'handle viene concesso l'accesso all'oggetto thread solo nell'estensione specificata nel parametro dwDesiredAccess .

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

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 (includere Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria	Kernel32.lib
DLL	Kernel32.dll