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) |