ReleaseSemaphoreWhenCallbackReturns function (Windows)

Switch View :
ScriptFree
ReleaseSemaphoreWhenCallbackReturns function

Applies to: desktop apps only

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

Syntax

VOID WINAPI ReleaseSemaphoreWhenCallbackReturns(
  __inout  PTP_CALLBACK_INSTANCE pci,
  __in     HANDLE sem,
  __in     DWORD crel
);

Parameters

pci [in, out]

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

sem [in]

A handle to the semaphore.

crel [in]

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

Minimum supported server

Windows Server 2008

Header

WinBase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

CallbackMayRunLong
DisassociateCurrentThreadFromCallback
FreeLibraryWhenCallbackReturns
LeaveCriticalSectionWhenCallbackReturns
ReleaseMutexWhenCallbackReturns
SetEventWhenCallbackReturns
Thread Pools
TrySubmitThreadpoolCallback

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012