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 |