GetUmsSystemThreadInformation-Funktion (winbase.h)

Fragt ab, ob der angegebene Thread ein UMS-Planerthread, ein UMS-Workerthread oder ein Nicht-UMS-Thread ist.

Syntax

BOOL GetUmsSystemThreadInformation(
  [in]      HANDLE                         ThreadHandle,
  [in, out] PUMS_SYSTEM_THREAD_INFORMATION SystemThreadInfo
);

Parameter

[in] ThreadHandle

Ein Handle für einen Thread. Das Threadhandle muss über das zugriffsrecht THREAD_QUERY_INFORMATION verfügen. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

[in, out] SystemThreadInfo

Ein Zeiger auf eine UMS_SYSTEM_THREAD_INFORMATION-Struktur , die Informationen zum angegebenen Thread empfängt.

Der Aufrufer muss den UmsVersion Member initialisieren, bevor er aufruft.

Rückgabewert

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die GetUmsSystemThreadInformation-Funktion ist für die Verwendung in Debuggern, Problembehandlungstools und Profilerstellungsanwendungen vorgesehen. Beispielsweise kann eine threadisolierende Ablaufverfolgung oder Anweisungen zum einmaligen Durchlaufen dazu führen, dass alle anderen Threads im Prozess angehalten werden. Wenn es sich bei dem zu verfolgenden Thread jedoch um einen UMS-Workerthread handelt, kann das Anhalten von UMS-Planerthreads zu einem Deadlock führen, da ein UMS-Arbeitsthread den Eingriff eines UMS-Planerthreads erfordert, um ausgeführt zu werden. Ein Debugger kann GetUmsSystemThreadInformation für jeden Thread aufrufen, den er möglicherweise angehalten hat, um die Art des Threads zu bestimmen, und ihn dann bei Bedarf für den zu debuggenden Code anhalten oder nicht.

Anforderungen