Funzione CreateThreadpoolWait (threadpoolapiset.h)
Crea un nuovo oggetto wait.
Sintassi
PTP_WAIT CreateThreadpoolWait(
[in] PTP_WAIT_CALLBACK pfnwa,
[in, out, optional] PVOID pv,
[in, optional] PTP_CALLBACK_ENVIRON pcbe
);
Parametri
[in] pfnwa
Funzione di callback da chiamare al termine o al timeout dell'attesa. Per informazioni dettagliate, vedere WaitCallback.
[in, out, optional] pv
Dati facoltativi definiti dall'applicazione da passare alla funzione di callback.
[in, optional] pcbe
Struttura TP_CALLBACK_ENVIRON che definisce l'ambiente in cui eseguire il callback. La funzione InitializeThreadpoolEnvironment restituisce questa struttura.
Se questo parametro è NULL, il callback viene eseguito nell'ambiente di callback predefinito. Per altre informazioni, vedere InitializeThreadpoolEnvironment.
Valore restituito
Se la funzione ha esito positivo, restituisce un puntatore a una struttura TP_WAIT che definisce l'oggetto wait. Le applicazioni non modificano i membri di questa struttura.
Se la funzione ha esito negativo, restituisce NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Commenti
Per impostare l'oggetto wait, chiamare la funzione SetThreadpoolWait o SetThreadpoolWaitEx .
L'elemento di lavoro e tutte le funzioni chiamate non devono basarsi sul thread dopo che sono stati restituiti. Non è pertanto possibile chiamare una chiamata asincrona che richiede un thread persistente, ad esempio la funzione RegNotifyChangeKeyValue senza il flag REG_NOTIFY_THREAD_AGNOSTIC , dall'ambiente di callback predefinito. Usare invece un thread il cui ciclo di vita viene controllato.
Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versione successiva.
Esempio
Per un esempio, vedere Uso delle funzioni del pool di thread.
Requisiti
| Client minimo supportato | Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | threadpoolapiset.h (include Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |