(RPC Manager Library)
| Description: | Attempts to acquire a Read lock for the specified service. Subroutine call only. |
| Returns: | Nothing |
Usage:  |
Script Only. |
| Related to: | WriteLock |
| Format: |
\RPCManager\ReadLock(ActivePtr, Service [, OptGUID]); |
| Parameters: |
| ActivePtr |
| Required. A pointer to a variable that will be set to "1" when the Read lock is obtained. |
| Service |
| Required. The name by which the service is known. |
| OptGUID |
| An optional parameter that is any expression giving the 16-byte binary form of the globally unique identifier (GUID) for the application in which the service instance is located. The default is the application to which the caller belongs. |
| Comments: | This subroutine is a member of the RPC Manager's Library, and must therefore be prefaced by \RPCManager\, as shown in the "Format" section. If the application you are developing is a script application, the subroutine call must be prefaced by System\RPCManager\, and the System variable must be declared in AppRoot.src. This module maintains a Read lock on a per service basis. This module is intended to be launched. It will set the value pointed to by ActivePtr to 1 when the lock is obtained. To release the lock, or stop waiting for it, simply stop this module by stopping the caller or explicitly slaying it. |
