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.
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"), ... ); ]