FSH SEMCLEAR: Difference between revisions
Created page with "This function allows an FSD to release a semaphore that was previously obtained on a call to FSH_SEMREQUEST. ==Syntax== FSH_SEMCLEAR(pSem) ==Parameters== ;pSem :is the ha..." |
mNo edit summary |
||
| Line 1: | Line 1: | ||
This function allows an FSD to release a semaphore that was previously obtained on a call to FSH_SEMREQUEST. | This function allows an FSD to release a semaphore that was previously obtained on a call to FSH_SEMREQUEST. | ||
==Syntax== | ==Syntax== | ||
FSH_SEMCLEAR(pSem) | FSH_SEMCLEAR(pSem) | ||
==Parameters== | ==Parameters== | ||
;pSem :is the handle to the system semaphore or the long address of the ram semaphore. | ;pSem: is the handle to the system semaphore or the long address of the ram semaphore. | ||
==Returns== | ==Returns== | ||
If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned: | If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned: | ||
*ERROR_EXCL_ALREADY_OWNED the exclusive semaphore is already owned. | |||
*ERROR_EXCL_ALREADY_OWNED the exclusive semaphore is already owned. | *ERROR_PROTECTION_VIOLATION the semaphore is inaccessible. | ||
==Calling Sequence== | ==Calling Sequence== | ||
<PRE> | <PRE> | ||
| Line 17: | Line 18: | ||
void far * pSem; | void far * pSem; | ||
</PRE> | </PRE> | ||
==Remarks== | ==Remarks== | ||
FSH_SEMCLEAR may block. | FSH_SEMCLEAR may block. | ||
;Note: | ;Note: OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate. | ||
[[Category:IFS Interfaces]] | [[Category:IFS Interfaces]] | ||
{{DISPLAYTITLE:FSH_SEMCLEAR}} | {{DISPLAYTITLE:FSH_SEMCLEAR}} | ||
Latest revision as of 05:43, 20 February 2020
This function allows an FSD to release a semaphore that was previously obtained on a call to FSH_SEMREQUEST.
Syntax
FSH_SEMCLEAR(pSem)
Parameters
- pSem
- is the handle to the system semaphore or the long address of the ram semaphore.
Returns
If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned:
- ERROR_EXCL_ALREADY_OWNED the exclusive semaphore is already owned.
- ERROR_PROTECTION_VIOLATION the semaphore is inaccessible.
Calling Sequence
int far pascal FSH_SEMCLEAR(pSem) void far * pSem;
Remarks
FSH_SEMCLEAR may block.
- Note
- OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate.