Função DeleteUmsThreadContext (winbase.h)

  • Artigo

Exclui o contexto de thread umS (agendamento de modo de usuário) especificado. O thread deve ser encerrado.

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 DeleteUmsThreadContext(
  [in] PUMS_CONTEXT UmsThread
);

Parâmetros

[in] UmsThread

Um ponteiro para o contexto de thread UMS a ser excluído. A função CreateUmsThreadContext fornece esse ponteiro.

Valor retornado

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.

Comentários

Um contexto de thread UMS não pode ser excluído até que o thread associado seja encerrado.

Quando um thread de trabalho umS termina de ser executado (por exemplo, retornando de sua função de ponto de entrada de thread), o sistema encerra o thread, define a terminação status no contexto de thread UMS do thread e enfileira o contexto de thread UMS para a lista de conclusão associada.

Qualquer tentativa de executar o thread UMS falhará porque o thread já foi encerrado.

Para marcar o status de encerramento de um thread, o agendador do aplicativo deve chamar QueryUmsThreadInformation com a classe de informações UmsIsThreadTerminated.

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)

Confira também

CreateUmsThreadContext

QueryUmsThreadInformation