Compartilhar via


Função UnregisterWait (winbase.h)

Cancela uma operação de espera registrada emitida pela função RegisterWaitForSingleObject .

Para usar um evento de conclusão, chame a função UnregisterWaitEx .

Sintaxe

BOOL UnregisterWait(
  [in] HANDLE WaitHandle
);

Parâmetros

[in] WaitHandle

O identificador de espera. Esse identificador é retornado pela função RegisterWaitForSingleObject .

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se qualquer função de retorno de chamada associada ao temporizador não tiver sido concluída quando UnregisterWait for chamado, UnregisterWait cancelará o registro da espera nas funções de retorno de chamada e falhará com o código de erro ERROR_IO_PENDING . O código de erro não indica que a função falhou e a função não precisa ser chamada novamente. Se o código exigir que um código de erro seja definido somente quando a operação de cancelamento de registro falhar, chame UnregisterWaitEx .

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0500 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Registerwaitforsingleobject

Funções de sincronização

Pooling de threads

UnregisterWaitEx