Funzione CallbackMayRunLong (threadpoolapiset.h)

Indica che il callback potrebbe non restituire rapidamente.

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

[in, out] pci

Puntatore a una struttura TP_CALLBACK_INSTANCE che definisce l'istanza di callback. Il puntatore viene passato alla funzione di callback.

La funzione restituisce TRUE se è disponibile un altro thread nel pool di thread per l'elaborazione dei callback o se il pool di thread è stato in grado di creare un nuovo thread. In questo caso, la funzione di callback corrente può usare il thread corrente per un periodo illimitato.

La funzione restituisce FALSE se un altro thread nel pool di thread non è disponibile per elaborare i callback e il pool di thread non è stato in grado di creare un nuovo thread. Il pool di thread tenterà di creare un nuovo thread dopo un ritardo, ma se la funzione di callback corrente viene eseguita a lungo, il pool di thread potrebbe perdere efficienza.

Il pool di thread può usare queste informazioni per determinare meglio quando creare un nuovo thread.

La funzione CallbackMayRunLong deve essere chiamata solo dal thread che sta elaborando il callback. La chiamata di questa funzione da un altro thread può causare una race condition.

La funzione CallbackMayRunLong contrassegna sempre il callback a esecuzione prolungata, indipendentemente dal fatto che sia disponibile o meno un thread per l'elaborazione dei callback o il pool di thread sia in grado di allocare un nuovo thread. Pertanto, questa funzione deve essere chiamata una sola volta, anche se restituisce FALSE.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versione successiva.

DisassociateCurrentThreadFromCallback

FreeLibraryWhenCallbackReturns

LeaveCriticalSectionWhenCallbackReturns

ReleaseMutexWhenCallbackReturns

ReleaseSemaphoreWhenCallbackReturns

SetEventWhenCallbackReturns

SetThreadpoolCallbackRunsLong

Pool di thread

TrySubmitThreadpoolCallback