Funzione QueryUmsThreadInformation (winbase.h)

Articolo
03/03/2024

Recupera informazioni sul thread di lavoro di pianificazione in modalità utente (UMS) specificato.

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 QueryUmsThreadInformation(
  [in]            PUMS_CONTEXT          UmsThread,
  [in]            UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [out]           PVOID                 UmsThreadInformation,
  [in]            ULONG                 UmsThreadInformationLength,
  [out, optional] PULONG                ReturnLength
);

Parametri

[in] UmsThread

Puntatore a un contesto di thread UMS.

[in] UmsThreadInfoClass

Valore UMS_THREAD_INFO_CLASS che specifica il tipo di informazioni da recuperare.

[out] UmsThreadInformation

Puntatore a un buffer per ricevere le informazioni specificate. Le dimensioni necessarie di questo buffer dipendono dalla classe di informazioni specificata.

Se la classe di informazioni è UmsThreadContext o UmsThreadTeb, il buffer deve essere sizeof(PVOID).

Se la classe di informazioni è UmsThreadIsSuspended o UmsThreadIsTerminata, il buffer deve essere sizeof(BOOLEAN).

[in] UmsThreadInformationLength

Dimensioni del buffer UmsThreadInformation , in byte.

[out, optional] ReturnLength

Puntatore a una variabile ULONG. Nell'output, questo parametro riceve il numero di byte scritti nel buffer UmsThreadInformation .

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. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
ERROR_INFO_LENGTH_MISMATCH	Il buffer è troppo piccolo per le informazioni richieste.
ERROR_INVALID_INFO_CLASS	La classe di informazioni specificata non è supportata.
ERROR_NOT_SUPPORTED	UMS non è supportato.

Commenti

La funzione QueryUmsThreadInformation recupera informazioni sul thread di lavoro UMS specificato, ad esempio il contesto definito dall'applicazione, il blocco di esecuzione del thread e se il thread viene sospeso o terminato.

Le strutture sottostanti per i thread di lavoro di messaggistica unificata vengono gestite dal sistema. Le informazioni non esposte tramite QueryUmsThreadInformation devono essere considerate riservate.

Requisiti

Requisito	Valore
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 (introdotto in Windows 7)

Vedi anche

SetUmsThreadInformation

UMS_THREAD_INFO_CLASS

Condividi tramite