LastCollectiveConfigChange Property (IPICollective interface)

                    

 

This read-only property indicates the last time the structure of the collective has changed. This is persisted by the SDK to determine when a fetch of structural information is required. The value is a PITime object.

 

Syntax

object.LastCollectiveConfigChange

The object placeholder is an object expression that evaluates to a IPICollective interface, obtained from a Server object.

Remarks

A copy of the LastCollectiveConfigChange is maintained on the client machine and compared to one retrieved each time a server is opened.  In this way the PI-SDK can determine if its knowledge of the collective structure is current without retrieving the data structure repeatedly.

To clear the current client value of LastCollectiveConfigChange, and consequently force an update of the collective information, call IRefresh.Refresh on the Server object. Then the next Server.Open call will trigger a fetch of the collective information.

Trappable Errors

In addition to generic errors (such as Out of Memory), the following errors may occur:

Error

Description

E_INVALIDARG, E_POINTER Some of the function argument are not valid.
pseSERVERNOTCOLLECTIVE The Server is not a collective
Enabling Operational Intelligence