Función DisassociateCurrentThreadFromCallback (threadpoolapiset.h)

Artículo
03/08/2023

Quita la asociación entre la función de devolución de llamada que se está ejecutando actualmente y el objeto que inició la devolución de llamada. El subproceso actual ya no contará como la ejecución de una devolución de llamada en nombre del objeto.

Sintaxis

void DisassociateCurrentThreadFromCallback(
  [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

None

Observaciones

Si este es el último subproceso que ejecuta una devolución de llamada en nombre del objeto, se liberarán los subprocesos que esperan que se completen las devoluciones de llamada del objeto.

El subproceso permanece asociado al grupo de limpieza del objeto hasta que el subproceso vuelve al grupo de subprocesos. Esto permite que las rutinas de apagado de DLL se sincronicen de forma segura con devoluciones de llamada pendientes y continúen con la descarga del código del archivo DLL cuando se hayan completado todas las devoluciones de llamada.

El objeto que genera la devolución de llamada sigue siendo válido durante la devolución de llamada. El objeto de devolución de llamada se puede reutilizar o liberar (aunque la sincronización con la versión del grupo de limpieza sigue siendo necesaria).

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

Requisitos


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