Função SetUmsThreadInformation (winbase.h)
Define informações de contexto específicas do aplicativo para o thread de trabalho ums (agendamento de 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 SetUmsThreadInformation(
[in] PUMS_CONTEXT UmsThread,
[in] UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
[in] PVOID UmsThreadInformation,
[in] ULONG UmsThreadInformationLength
);
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 definido. Esse parâmetro deve ser UmsThreadUserContext.
[in] UmsThreadInformation
Um ponteiro para um buffer que contém as informações a serem definidas.
[in] UmsThreadInformationLength
O tamanho do buffer UmsThreadInformation , em bytes.
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 tamanho do buffer não corresponde ao tamanho necessário para a classe de informações especificada. |
|
O parâmetro UmsThreadInfoClass especifica uma classe de informações sem suporte. |
|
Não há suporte para UMS. |
Comentários
A função SetUmsThreadInformation pode ser usada para definir um contexto definido pelo aplicativo para o thread de trabalho umS especificado. As informações de contexto podem consistir em qualquer coisa que o aplicativo possa achar útil para acompanhar, como por agendador ou por estado de thread de trabalho. As estruturas subjacentes para threads de trabalho ums são gerenciadas pelo sistema e não devem ser modificadas diretamente.
A função QueryUmsThreadInformation pode ser usada para recuperar outras informações expostas sobre o thread especificado, como seu TEB (bloco de execução de thread) e se o thread está suspenso ou encerrado. As informações que não são expostas por meio de QueryUmsThreadInformation devem ser consideradas reservadas.
Requisitos
| 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 (incluir Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |
| Conjunto de APIs | api-ms-win-core-ums-l1-1-0 (introduzido no Windows 7) |