OpenThread-Funktion (processthreadsapi.h)

Artikel
08/25/2023

Ö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