Funzione DeleteUmsThreadContext (winbase.h)

Elimina il contesto di pianificazione in modalità utente (UMS) specificato. Il thread deve essere terminato.

Avviso

A partire da Windows 11, la pianificazione in modalità utente non è supportata. Tutte le chiamate hanno esito negativo con l'errore ERROR_NOT_SUPPORTED.

Sintassi

BOOL DeleteUmsThreadContext(
  [in] PUMS_CONTEXT UmsThread
);

Parametri

[in] UmsThread

Puntatore al contesto del thread UMS da eliminare. La funzione CreateUmsThreadContext fornisce questo puntatore.

Valore restituito

Se la funzione ha esito positivo, restituisce un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Un contesto del thread UMS non può essere eliminato finché il thread associato non è terminato.

Quando un thread di lavoro UMS termina l'esecuzione (ad esempio, restituisce dalla funzione del punto di ingresso del thread), il sistema termina il thread, imposta lo stato di terminazione nel contesto del thread UMS del thread del thread e accoda il contesto del thread UMS all'elenco di completamento associato.

Qualsiasi tentativo di esecuzione del thread UMS avrà esito negativo perché il thread è già terminato.

Per controllare lo stato di terminazione di un thread, l'utilità di pianificazione dell'applicazione deve chiamare QueryUmsThreadInformation con la classe di informazioni UmsIsThreadTerminated.

Requisiti

Client minimo supportato	Windows 7 (solo a 64 bit) [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll
Set di API	api-ms-win-core-ums-l1-1-0 (introdotta in Windows 7)

Vedi anche

CreateUmsThreadContext

QueryUmsThreadInformation