Releases units to an RT semaphore. Threads waiting on the RT semaphore may be allowed to run (released) if this call supplies all the units they were waiting for.

Visual Basic:

Sub ntxReleaseRtSemaphore(
  ByVal hSemaphore As Integer,
  ByVal wUnits As Short)

Visual C#:

void ntxReleaseRtSemaphore (
  Int32 hSemaphore,
  Int16 wUnits );

Parameters

hSemaphore

The handle to the RT semaphore.

wUnits

The number of units to send.

Status

E_LIMIT

The semaphore's maximum unit count would have been exceeded. A semaphore's maximum unit count is determined when it is created.

E_EXIST

hSemaphore is not a handle for an existing object.

E_TYPE

hSemaphore is not a handle for a semaphore.

E_NTX_INTERNAL_ERROR

The DLL could not contact the RT kernel to complete the request.

Requirements

See Also

INtimeDotNet system calls, Semaphore system calls