RestoreServers Method (IPIRestorer interface)

              

 

This method restores the servers from the objects in the persistence string (persistenceData) passed.

 

Syntax

object.RestoreServers persistenceData, pErrors, pnvsContext

The RestoreObject method syntax has these parts:

Part

Description

object

An object expression that evaluates to a PIGlobalRestorer object.

persistenceData

The persistence string. This string is obtained from the original object using the IPIPersist interface.

pErrors

A PIErrors collection containing any errors encountered.

pnvsContext

A NamedValues collection containing context variables.

 

Context Variables

Context variables can affect how the object is restored. More information can be found on the Context help page for PIGlobalRestorer  (See Also).

 

Remarks

Returns a NamedValues collection of the servers in the persistence string. The Name property of each NamedValue is the server name. The Value property of each NamedValue is a pointer to the Server object.

 

Trappable Errors

This method should only return generic errors (such as Out of Memory); errors are returned in the pErrors collection.

   

Errors Collection Errors

Here are some of the errors that can be returned in the errors collection (pErrors). The Cause property of each PIError is set to the persistence string for the object that generated the error.  You need to check the errors collection even if the method returns S_OK, since some objects contain more than one persisted objects inside.

Error

Description

pseRESTORESERVERS

There was an error restoring the servers for an object.

pseRESTOREOBJECT

There was an error restoring the object to find its server.

Enabling Operational Intelligence