Freigeben über


OpenThread-Funktion (processthreadsapi.h)

Öffnet ein vorhandenes Threadobjekt.

Syntax

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

Parameter

[in] dwDesiredAccess

Der Zugriff auf das Threadobjekt. Dieses Zugriffsrecht wird anhand des Sicherheitsdeskriptors für den Thread überprüft. Bei diesem Parameter kann es sich um eine oder mehrere der Threadzugriffsrechte handelt.

Wenn der Aufrufer die SeDebugPrivilege-Berechtigung aktiviert hat, wird der angeforderte Zugriff unabhängig vom Inhalt des Sicherheitsdeskriptors gewährt.

[in] bInheritHandle

Wenn dieser Wert TRUE ist, erben von diesem Prozess erstellte Prozesse das Handle. Andernfalls erben die Prozesse dieses Handle nicht.

[in] dwThreadId

Der Bezeichner des zu öffnenden Threads.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein geöffnetes Handle für den angegebenen Thread.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Das von OpenThread zurückgegebene Handle kann in jeder Funktion verwendet werden, die ein Handle für einen Thread erfordert, z. B. die Wartefunktionen, sofern Sie die entsprechenden Zugriffsrechte angefordert haben. Dem Handle wird nur zugriff auf das Threadobjekt gewährt, soweit es im dwDesiredAccess-Parameter angegeben wurde.

Wenn Sie mit dem Handle fertig sind, schließen Sie es mithilfe der CloseHandle-Funktion .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile processthreadsapi.h (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

CloseHandle

GetExitCodeThread

GetThreadContext

Prozess- und Threadfunktionen

ResumeThread

SetThreadContext

SetTokenInformation

SuspendThread

TerminateThread

Threads