(RPC Manager Library)
Description: This module attempts to acquire a Read lock for the specified service. Subroutine call only.
Returns: Nothing
Usage: Script
Format: \RPCManager\ReadLock(ActivePtr, Service [, OptGUID]);
Parameters: ActivePtr { pointer } { required } { no default: }
A pointer to a variable that will be set to "1" when the Read lock is obtained.
Service { text } { required } { no default: }
The name by which the service is known.
OptGUID an optional parameter indicating the GUID of 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 AppMod.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.
See Also: