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.

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.

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

Confira também

QueryUmsThreadInformation