IDFromServer Method (IServerID interface)

                    

 

This  method returns the current Server ID from the Server as a string.

 

Syntax

object.IDFromServer 

The IDFromServer method syntax has these parts:

Part

Description

object

An object expression that evaluates to a IServerID interface obtained from a Server object.

 

Remarks

This method may be used to aid in a situation where the server ID returned by a PI server has changed.  This is described in the IServerID documentation (See Also).  One method of dealing with this change is to reset the Known Servers Table server ID entry for this server.  This is described in the ResetKSTServerID method of this Inteface.  Another way of handing this situation is to enter the new Server ID with the desired server handle (local name) in the Servers.Aliases table.  This table is consulted during the Server.Open method.  If the server ID returned during the Open method matches an entry in the Servers.Aliases table and the handle for that server ID matches the handle currently being opened, the pseSERVERIDMISMATCH error is not raised.  As the change of a Server ID on the server is not a normal event, it is important that the caller of this method ensures the server being connected to is actually the desired server before making such an entry in the Servers.Aliases table.   

Enabling Operational Intelligence