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 |