Función CallbackMayRunLong (threadpoolapiset.h)

Artículo
08/26/2023

Indica que es posible que la devolución de llamada no se devuelva rápidamente.

Sintaxis

BOOL CallbackMayRunLong(
  [in, out] PTP_CALLBACK_INSTANCE pci
);

Parámetros

[in, out] pci

Puntero a una estructura de TP_CALLBACK_INSTANCE que define la instancia de devolución de llamada. El puntero se pasa a la función de devolución de llamada.

Valor devuelto

La función devuelve TRUE si otro subproceso del grupo de subprocesos está disponible para procesar devoluciones de llamada o el grupo de subprocesos pudo crear un subproceso nuevo. En este caso, la función de devolución de llamada actual puede usar el subproceso actual indefinidamente.

La función devuelve FALSE si otro subproceso del grupo de subprocesos no está disponible para procesar devoluciones de llamada y el grupo de subprocesos no pudo crear un subproceso nuevo. El grupo de subprocesos intentará crear un subproceso después de un retraso, pero si la función de devolución de llamada actual se ejecuta durante mucho tiempo, el grupo de subprocesos puede perder eficacia.

Comentarios

El grupo de subprocesos puede usar esta información para determinar mejor cuándo se debe crear un nuevo subproceso.

El subproceso que está procesando la devolución de llamada debe llamar a la función CallbackMayRunLong . Llamar a esta función desde otro subproceso puede provocar una condición de carrera.

La función CallbackMayRunLong siempre marca la devolución de llamada como de ejecución prolongada, tanto si un subproceso está disponible para procesar devoluciones de llamada como si el grupo de subprocesos puede asignar un nuevo subproceso. Por lo tanto, esta función solo se debe llamar una vez, incluso si devuelve FALSE.

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o superior.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	threadpoolapiset.h (incluya Windows.h en Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll