Función UnhookWinEvent (winuser.h)

Quita una función de enlace de eventos creada por una llamada anterior a SetWinEventHook.

Sintaxis

BOOL UnhookWinEvent(
  [in] HWINEVENTHOOK hWinEventHook
);

Parámetros

[in] hWinEventHook

Tipo: HWINEVENTHOOK

Identificador del enlace de eventos devuelto en la llamada anterior a SetWinEventHook.

Valor devuelto

Tipo: BOOL

Si se ejecuta correctamente, devuelve TRUE; de lo contrario, devuelve FALSE.

Tres errores comunes hacen que se produzca un error en esta función:

• El parámetro hWinEventHook es NULL o no es válido.
• El enlace de eventos especificado por hWinEventHook ya se ha quitado.
• Se llama a UnhookWinEvent desde un subproceso diferente de la llamada original a SetWinEventHook.

Comentarios

Esta función quita el enlace de eventos especificado por hWinEventHook que impide que la función de devolución de llamada correspondiente reciba más notificaciones de eventos. Si el subproceso del cliente finaliza, el sistema llama automáticamente a esta función.

Llame a esta función desde el mismo subproceso que instaló el enlace de eventos. Se produce un error en UnhookWinEvent si se llama desde un subproceso diferente de la llamada que corresponde a SetWinEventHook.

Si WINEVENT_INCONTEXT se especificó cuando se instaló este enlace de eventos, el sistema intenta descargar el archivo DLL correspondiente de todos los procesos que lo cargaron. Aunque la descarga no se produce inmediatamente, no se llama a la función de enlace después de que UnhookWinEvent devuelva. Para obtener más información sobre WINEVENT_INCONTEXT, vea Funciones de enlace en contexto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Redistribuible	RDK de accesibilidad activa 1.3 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 95