FreeLibraryWhenCallbackReturns function (threadpoolapiset.h)

Specifies the DLL that the thread pool will unload when the current callback completes.

Syntax

void FreeLibraryWhenCallbackReturns(
  [in, out] PTP_CALLBACK_INSTANCE pci,
  [in]      HMODULE               mod
);

Parameters

[in, out] pci

A pointer to a TP_CALLBACK_INSTANCE structure that defines the callback instance. The pointer is passed to the callback function.

[in] mod

A handle to the DLL.

Return value

None

Remarks

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

Requirements

Requirement Value
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.h on Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
DLL Kernel32.dll

See also

CallbackMayRunLong

DisassociateCurrentThreadFromCallback

LeaveCriticalSectionWhenCallbackReturns

ReleaseMutexWhenCallbackReturns

ReleaseSemaphoreWhenCallbackReturns

SetEventWhenCallbackReturns

Thread Pools

TrySubmitThreadpoolCallback