IsPotentialServer

(RPC Manager Library)

Description: Is Potential Server for a Service. This subroutine returns an indication of whether the local workstation is a potential server for a service. Returns "1" if the local workstation can be a server for the specified service. IsPotentialServer should not be called in steady state.
Returns: Boolean
Usage: Script Only.
Function Groups: Network
Related to: ConnectToMachine | DisconnectFromMachine | GetServer | GetServersListed | GetStatus | IsClient | IsPrimaryServer | Register (RPC Manager) | Send | SetRemoteValue
Format: \RPCManager\IsPotentialServer(ServiceName [, OptGUID])
Parameters:  
ServiceName  
Required. The name by which the service is known.
OptGUID
Any optional parameter that provides 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 AppRoot.src.
This function returns Invalid if the local service instance is not running.
If the 16-byte binary format of the GUID is not known, the GetGUID function 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:

  If 1 Main;
  [
    IfThen(\RPCManager\IsPotentialServer("ModemManager"), 
          ... 
          ); 
  ]

RPC Manager Service