Funzione OpenThread (processthreadsapi.h)

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

Vedere anche

Closehandle

GetExitCodeThread

GetThreadContext

Funzioni di processi e thread

ResumeThread

SetThreadContext

SetTokenInformation

SuspendThread

TerminateThread

Thread