Função QueryUmsThreadInformation (winbase.h)
Recupera informações sobre o thread de trabalho do UMS (agendamento no modo de usuário) especificado.
Aviso
A partir de Windows 11, não há suporte para o agendamento no modo de usuário. Todas as chamadas falham com o erro ERROR_NOT_SUPPORTED.
Sintaxe
BOOL QueryUmsThreadInformation(
[in] PUMS_CONTEXT UmsThread,
[in] UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
[out] PVOID UmsThreadInformation,
[in] ULONG UmsThreadInformationLength,
[out, optional] PULONG ReturnLength
);
Parâmetros
[in] UmsThread
Um ponteiro para um contexto de thread umS.
[in] UmsThreadInfoClass
Um valor UMS_THREAD_INFO_CLASS que especifica o tipo de informação a ser recuperada.
[out] UmsThreadInformation
Um ponteiro para um buffer para receber as informações especificadas. O tamanho necessário desse buffer depende da classe de informações especificada.
Se a classe de informações for UmsThreadContext ou UmsThreadTeb, o buffer deverá ser sizeof(PVOID).
Se a classe de informações for UmsThreadIsSuspended ou UmsThreadIsTerminated, o buffer deverá ser sizeof(BOOLEAN).
[in] UmsThreadInformationLength
O tamanho do buffer UmsThreadInformation , em bytes.
[out, optional] ReturnLength
Um ponteiro para uma variável ULONG. Na saída, esse parâmetro recebe o número de bytes gravados no buffer UmsThreadInformation .
Retornar valor
Se a função for bem-sucedida, ela retornará um valor diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Os valores de erro possíveis incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
O buffer é muito pequeno para as informações solicitadas. |
|
Não há suporte para a classe de informações especificada. |
|
Não há suporte para UMS. |
Comentários
A função QueryUmsThreadInformation recupera informações sobre o thread de trabalho ums especificado, como seu contexto definido pelo aplicativo, seu TEB (bloco de execução de thread) e se o thread está suspenso ou encerrado.
As estruturas subjacentes para threads de trabalho ums são gerenciadas pelo sistema. As informações que não são expostas por meio de QueryUmsThreadInformation devem ser consideradas reservadas.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 (somente 64 bits) [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |
| Conjunto de APIs | api-ms-win-core-ums-l1-1-0 (introduzido no Windows 7) |