GetServer
(RPC Manager Library)
Description: | Returns the name of the active server for a specified service. |
Returns: | Text |
Usage: | Steady State only. |
Function Groups: | Network |
Related to: | ConnectToMachine | DisconnectFromMachine | GetServersListed | GetStatus | IsClient | IsPotentialServer | IsPrimaryServer | Register (RPC Manager) | Send | SetRemoteValue | GetGUID |
Format: | \RPCManager.GetServer(ServiceName [, OptGUID]) |
Parameters: |
ServiceName |
Required. Any text expression giving the name of the service for which to get the active server's name. |
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 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:
SName = \RPCManager.GetServer("ModemManager");