CloseThreadpoolWork function

Releases the specified work object.

Syntax

void CloseThreadpoolWork(
  PTP_WORK pwk
);

Parameters

pwk

A TP_WORK structure that defines the work object. The CreateThreadpoolWork function returns this structure.

Return Value

This function does not return a value.

Remarks

The work object is freed immediately if there are no outstanding callbacks; otherwise, the work object is freed asynchronously after the outstanding callbacks complete.

If there is a cleanup group associated with the work object, it is not necessary to call this function; calling the CloseThreadpoolCleanupGroupMembers function releases the work, wait, and timer objects associated with the cleanup group.

To compile an application that uses this function, define _WIN32_WINNT as 0x0600 or higher.

Requirements

   
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header threadpoolapiset.h (include Windows 7, Windows Server 2008 Windows Server 2008 R2, Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

CreateThreadpoolWork

SubmitThreadpoolWork

Thread Pools

WaitForThreadpoolWorkCallbacks