Función UnregisterWait (winbase.h)

Cancela una operación de espera registrada emitida por la función RegisterWaitForSingleObject .

Para usar un evento de finalización, llame a la función UnregisterWaitEx .

Sintaxis

BOOL UnregisterWait(
  [in] HANDLE WaitHandle
);

Parámetros

[in] WaitHandle

Identificador de espera. La función RegisterWaitForSingleObject devuelve este identificador.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si no se han completado las funciones de devolución de llamada asociadas al temporizador cuando se llama a UnregisterWait , UnregisterWait anula el registro de la espera en las funciones de devolución de llamada y se produce un error con el código de error ERROR_IO_PENDING . El código de error no indica que se ha producido un error en la función y no es necesario volver a llamar a la función. Si el código requiere un código de error para establecer solo cuando se ha producido un error en la operación de anulación del registro, llame a UnregisterWaitEx en su lugar.

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0500 o posterior. Para obtener más información, vea Uso de los encabezados de Windows.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

RegisterWaitForSingleObject

Funciones de sincronización

Agrupación de subprocesos

Anular el registroWaitEx