0 out of 1 rated this helpful - Rate this topic

FreeLibraryWhenCallbackReturns function

Applies to: desktop apps only

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

Syntax

VOID WINAPI FreeLibraryWhenCallbackReturns(
  __inout  PTP_CALLBACK_INSTANCE pci,
  __in     HMODULE mod
);

Parameters

pci [in, out]

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

mod [in]

A handle to the DLL.

Return value

This function does not return a value.

Remarks

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

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

WinBase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

CallbackMayRunLong
DisassociateCurrentThreadFromCallback
LeaveCriticalSectionWhenCallbackReturns
ReleaseMutexWhenCallbackReturns
ReleaseSemaphoreWhenCallbackReturns
SetEventWhenCallbackReturns
Thread Pools
TrySubmitThreadpoolCallback

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
FreeLibraryWhenCallbackReturns can only be called once per callback
If FreeLibraryWhenCallbackReturns is called more than once per callback, then a SEH exception will be thrown by the ThreadPool implementation.