Função GetUmsCompletionListEvent (winbase.h)

Recupera um identificador para o evento associado à lista de conclusão de UMS (agendamento de modo de usuário) especificada.

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 GetUmsCompletionListEvent(
  [in]      PUMS_COMPLETION_LIST UmsCompletionList,
  [in, out] PHANDLE              UmsCompletionEvent
);

Parâmetros

[in] UmsCompletionList

Um ponteiro para uma lista de conclusão de UMS. A função CreateUmsCompletionList fornece esse ponteiro.

[in, out] UmsCompletionEvent

Um ponteiro para uma variável HANDLE. Na saída, o parâmetro UmsCompletionEvent é definido como um identificador para o evento associado à lista de conclusão especificada.

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.

Comentários

O sistema sinaliza um evento de lista de conclusão umS quando o sistema enfileira itens para uma lista de conclusão vazia. Um identificador de evento de lista de conclusão pode ser usado com qualquer função de espera que leve um identificador para um evento. Quando o evento é sinalizado, um aplicativo normalmente chama DequeueUmsCompletionListItems para recuperar o conteúdo da lista de conclusão.

O identificador de evento permanece válido até que sua lista de conclusão seja excluída. Não use o identificador de evento para aguardar uma lista de conclusão que tenha sido excluída ou esteja em processo de exclusão.

Quando o identificador não for mais necessário, use a função CloseHandle para fechar o identificador.

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 (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

CreateUmsCompletionList

DequeueUmsCompletionListItems

Funções de espera