GetThreadId-Funktion (processthreadsapi.h)

  • Artikel

Ruft den Threadbezeichner des angegebenen Threads ab.

Syntax

DWORD GetThreadId(
  [in] HANDLE Thread
);

Parameter

[in] Thread

Ein Handle auf den Thread. Das Handle muss über das THREAD_QUERY_INFORMATION- oder THREAD_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen zu Zugriffsrechten finden Sie unter Threadsicherheit und Zugriffsrechte.

Windows Server 2003: Das Handle muss über das zugriffsrecht THREAD_QUERY_INFORMATION verfügen.

Rückgabewert

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Bis ein Thread beendet wird, identifiziert der Threadbezeichner ihn eindeutig im System.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0502 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen

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

Siehe auch

GetCurrentThreadId

GetProcessId

GetProcessIdOfThread

Prozess- und Threadfunktionen

Threads