FS CANCELLOCKREQUEST: Difference between revisions
Created page with "Cancels an outstanding FS_FILELOCKS request on a file. ==Syntax== FS_CANCELLOCKREQUEST(psffsi, psffsd, pLockRange) ==Parameters== ;psffsi: is a pointer to the file-syste..." |
mNo edit summary |
||
| Line 1: | Line 1: | ||
Cancels an outstanding FS_FILELOCKS request on a file. | {{DISPLAYTITLE:FS_CANCELLOCKREQUEST}} | ||
Cancels an outstanding FS_FILELOCKS request on a file. | |||
==Syntax== | ==Syntax== | ||
FS_CANCELLOCKREQUEST(psffsi, psffsd, pLockRange) | FS_CANCELLOCKREQUEST(psffsi, psffsd, pLockRange) | ||
==Parameters== | ==Parameters== | ||
;psffsi: is a pointer to the file-system-independent portion of an open file instance. | ;psffsi: is a pointer to the file-system-independent portion of an open file instance. | ||
;psffsd: is a pointer to the file-system-dependent portion of an open file instance. | |||
;psffsd: is a pointer to the file-system-dependent portion of an open file instance. | ;pLockRange: is a pointer to a filelock structure. The filelock structure has the following format: | ||
;pLockRange: is a pointer to a filelock structure. The filelock structure has the following format: | |||
struct FileLock { | struct FileLock { | ||
unsigned long FileOffset; /* offset where the lock/unlock begins */ | unsigned long FileOffset; /* offset where the lock/unlock begins */ | ||
unsigned long RangeLength; /* length of region locked/unlocked */ | unsigned long RangeLength; /* length of region locked/unlocked */ | ||
} | } | ||
== | ==Calling Sequence== | ||
<PRE> | <PRE> | ||
int far pascal FS_CANCELLOCKREQUEST(psffsi, psffsd, pLockRange) | int far pascal FS_CANCELLOCKREQUEST(psffsi, psffsd, pLockRange) | ||
| Line 24: | Line 22: | ||
struct filelock far * pLockRange; | struct filelock far * pLockRange; | ||
</PRE> | </PRE> | ||
==Remarks== | ==Remarks== | ||
This entry point was added to support the 32-bit DosCancelLockRequest API . | This entry point was added to support the 32-bit DosCancelLockRequest API. | ||
This function provides a simple mechanism for canceling the lock range request of an outstanding FS_FILELOCKS call. If two threads in a process are blocked on a lock range and a cancel request is issued by another thread, both blocked threads will be released. | This function provides a simple mechanism for canceling the lock range request of an outstanding FS_FILELOCKS call. If two threads in a process are blocked on a lock range and a cancel request is issued by another thread, both blocked threads will be released. | ||
[[Category:IFS Interfaces]] | [[Category:IFS Interfaces]] | ||
Latest revision as of 02:45, 10 February 2020
Cancels an outstanding FS_FILELOCKS request on a file.
Syntax
FS_CANCELLOCKREQUEST(psffsi, psffsd, pLockRange)
Parameters
- psffsi
- is a pointer to the file-system-independent portion of an open file instance.
- psffsd
- is a pointer to the file-system-dependent portion of an open file instance.
- pLockRange
- is a pointer to a filelock structure. The filelock structure has the following format:
struct FileLock {
unsigned long FileOffset; /* offset where the lock/unlock begins */
unsigned long RangeLength; /* length of region locked/unlocked */
}
Calling Sequence
int far pascal FS_CANCELLOCKREQUEST(psffsi, psffsd, pLockRange) struct sffsi far * psffsi; struct sffsd far * psffsd; struct filelock far * pLockRange;
Remarks
This entry point was added to support the 32-bit DosCancelLockRequest API.
This function provides a simple mechanism for canceling the lock range request of an outstanding FS_FILELOCKS call. If two threads in a process are blocked on a lock range and a cancel request is issued by another thread, both blocked threads will be released.