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.

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

Confira também

CreateUmsCompletionList

DequeueUmsCompletionListItems

Funções de espera