Função CreateUmsThreadContext (winbase.h)
Cria um contexto de thread de UMS (agendamento no modo de usuário) para representar um thread de trabalho umS.
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 CreateUmsThreadContext(
[out] PUMS_CONTEXT *lpUmsThread
);
Parâmetros
[out] lpUmsThread
Uma variável PUMS_CONTEXT. Na saída, esse parâmetro recebe um ponteiro para um contexto de thread umS.
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 |
|---|---|
|
Não há memória suficiente disponível para criar o contexto de thread ums. |
Comentários
Um contexto de thread UMS representa o estado de um thread de trabalho umS. Os contextos de thread são usados para especificar threads de trabalho ums em chamadas de função.
Um thread de trabalho da UMS é criado chamando a função CreateRemoteThreadEx depois de usar InitializeProcThreadAttributeList e UpdateProcThreadAttribute para preparar uma lista de atributos UMS para o thread.
As estruturas subjacentes para um contexto de thread umS são gerenciadas pelo sistema e não devem ser modificadas diretamente. Para obter e definir informações sobre um thread de trabalho umS, use as funções QueryUmsThreadInformation e SetUmsThreadInformation .
Depois que um thread de trabalho umS for encerrado, seu contexto de thread deverá ser liberado chamando DeleteUmsThreadContext.
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) |