Função CreateThreadpoolWork (threadpoolapiset.h)
Cria um novo objeto de trabalho.
Sintaxe
PTP_WORK CreateThreadpoolWork(
[in] PTP_WORK_CALLBACK pfnwk,
[in, out, optional] PVOID pv,
[in, optional] PTP_CALLBACK_ENVIRON pcbe
);
Parâmetros
[in] pfnwk
A função do retorno de chamada. Um thread de trabalho chama esse retorno de chamada sempre que você chama SubmitThreadpoolWork para postar o objeto de trabalho. Para obter detalhes, consulte WorkCallback.
[in, out, optional] pv
Dados opcionais definidos pelo aplicativo para passar para a função de retorno de chamada.
[in, optional] pcbe
Um ponteiro para uma estrutura TP_CALLBACK_ENVIRON que define o ambiente no qual executar o retorno de chamada. Use a função InitializeThreadpoolEnvironment para inicializar a estrutura antes de chamar essa função.
Se esse parâmetro for NULL, o retorno de chamada será executado no ambiente de retorno de chamada padrão. Para obter mais informações, consulte InitializeThreadpoolEnvironment.
Retornar valor
Se a função for bem-sucedida, ela retornará um ponteiro para uma estrutura TP_WORK que define o objeto de trabalho. Os aplicativos não modificam os membros dessa estrutura.
Se a função falhar, ela retornará NULL. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou superior.
Exemplos
Para obter um exemplo, consulte Usando as funções do pool de threads.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | threadpoolapiset.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |