Freigeben über

PsGetThreadId-Funktion (ntddk.h)

  • Artikel

Diese Routine gibt den eindeutigen Bezeichner (ID) eines bestimmten Threads zurück.

Syntax

HANDLE PsGetThreadId(
  [in] PETHREAD Thread
);

Parameter

[in] Thread

Ein Zeiger auf eine Geschäftsleitungsthreadobjektstruktur (ETHREAD).

Rückgabewert

Gibt ein HANDLE zurück, das die eindeutige ID des vom Aufrufer bereitgestellten Threads ist.

Bemerkungen

Ein Treiber ruft Möglicherweise PsGetThreadId aus mehreren Gründen auf:

  • Threadidentifikation: Die von PsGetThreadId zurückgegebene Thread-ID ist systemweit eindeutig, nicht nur innerhalb eines einzelnen Prozesses.

  • Debuggen und Protokollierung: Thread-IDs werden häufig beim Debuggen und Protokollieren verwendet, um die Ausführung des Programms zu verfolgen.

Thread-ID ist für eine Startsitzung nicht eindeutig. Nachdem ein Thread seine ID beendet hat, kann wiederverwendet werden.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows XP
Header- ntddk.h
IRQL- <= DISPATCH_LEVEL