ReleaseSemaphoreWhenCallbackReturns function

Specifies the semaphore that the thread pool will release when the current callback completes.

Syntax

void ReleaseSemaphoreWhenCallbackReturns(
  PTP_CALLBACK_INSTANCE pci,
  HANDLE                sem,
  DWORD                 crel
);

Parameters

pci

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

sem

A handle to the semaphore.

crel

The amount by which to increment the semaphore object's count.

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 [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

CallbackMayRunLong

DisassociateCurrentThreadFromCallback

FreeLibraryWhenCallbackReturns

LeaveCriticalSectionWhenCallbackReturns

ReleaseMutexWhenCallbackReturns

SetEventWhenCallbackReturns

Thread Pools

TrySubmitThreadpoolCallback