GetStatus

(RPC Manager Library)

Description: Returns a variable that holds the current service instance status for the specified service.
Returns: Numeric
Usage: Steady State only.
Function Groups: Compilation and On-Line Modifications,  Network
Related to: ConnectToMachine | DisconnectFromMachine | GetGUID | GetServer | GetServersListed | IsClient | IsPotentialServer | IsPrimaryServer | Register (RPC Manager) | Send | SetRemoteValue
Format: \RPCManager.GetStatus(ServiceName [, OptGUID])
Parameters:  
ServiceName
Required. Any text expression giving the name of the service for which to get the connection status.
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 module 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 module call must be prefaced by System\RPCManager\, and the System variable must be declared in AppRoot.src.
The return value from this subroutine is the current status of a service on the local workstation. It is similar to the return value for the Register module, except that in that case it is a pointer to the value that is returned rather than the value itself.
If the 16-byte binary format of the GUID is not known, the GetGUID module may be used to obtain it.

 

To obtain a list of service names for your application, open the Trace Viewer Application, connect to RPC Diagnostics, then open the Services Dialog

Example:

  status = \RPCManager.GetStatus("ModemManager");

Related information:

RPC Manager Service