Função QueryUmsThreadInformation (winbase.h)

  • Artigo

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
ERROR_INFO_LENGTH_MISMATCH
 O buffer é muito pequeno para as informações solicitadas.
ERROR_INVALID_INFO_CLASS
 Não há suporte para a classe de informações especificada.
ERROR_NOT_SUPPORTED
 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)

Confira também

SetUmsThreadInformation

UMS_THREAD_INFO_CLASS