GetUmsSystemThreadInformation-Funktion (winbase.h)

  • Artikel

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

Warnung

Ab Windows 11 wird die Planung im Benutzermodus nicht unterstützt. Alle Aufrufe schlagen mit dem Fehler ERROR_NOT_SUPPORTEDfehl.

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 mit SP1 [nur Desktop-Apps],Windows 7 (nur 64-Bit) und Windows Server 2008 R2 mit installiertem KB977165
Unterstützte Mindestversion (Server) Windows Server 2008 R2 mit SP1 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbase.h (Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll
APIs api-ms-win-core-ums-l1-1-0 (eingeführt in Windows 7)