DeleteUmsThreadContext-Funktion (winbase.h)

Löscht den angegebenen UMS-Threadkontext (User Mode Scheduling). Der Thread muss beendet werden.

Warnung

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

Syntax

BOOL DeleteUmsThreadContext(
  [in] PUMS_CONTEXT UmsThread
);

Parameter

[in] UmsThread

Ein Zeiger auf den zu löschenden UMS-Threadkontext. Die CreateUmsThreadContext-Funktion stellt diesen Zeiger bereit.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ein Wert ungleich null zurückgegeben.

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

Hinweise

Ein UMS-Threadkontext kann erst gelöscht werden, wenn der zugeordnete Thread beendet wurde.

Wenn die Ausführung eines UMS-Workerthreads beendet wird (z. B. durch Zurückgeben von seiner Threadeinstiegspunktfunktion), beendet das System den Thread, legt die Beendigung status im UMS-Threadkontext des Threads fest und stellt den UMS-Threadkontext in die Warteschlange der zugeordneten Vervollständigungsliste.

Jeder Versuch, den UMS-Thread auszuführen, schlägt fehl, da der Thread bereits beendet wurde.

Um die Beendigung status eines Threads zu überprüfen, sollte der Scheduler der Anwendung QueryUmsThreadInformation mit der Informationsklasse UmsIsThreadTerminated aufrufen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7 (nur 64-Bit) [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [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)

Weitere Informationen

CreateUmsThreadContext

QueryUmsThreadInformation