TimedValues Method (PIData object)

                    

 

This method returns a PIValues collection that contains the interpolated values from the archive at the passed time stamps.

Syntax

object.TimedValues TimedStamps, [FilterExp], [ShowFiltered], [bShowDiscreteTimes], [AsyncStatus]

The TimedValues method syntax has these parts:

Part Description

object

An object expression that evaluates to a PIData object.

TimedStamps

Variant containing a SAFEARRAY of localDates, a SAFEARRAY of PITime objects, a SAFEARRAY of numerics interpreted as seconds since 1970 or a PIValues collection where the times are used and the values are ignored. See the settings section.

FilterExp

A string containing a filter expression [Optional]

ShowFiltered

A value from the FilteredViewConstants  enumeration that controls whether filtered events are returned with a filter status or not shown at all. [Optional. Default is fvShowFilteredState]

bShowDiscreteTimes

If this is set true for discrete points, return the actual times of the recorded values rather than the passed times. Discrete points return values at or before each time requested.[Optional. Default is false]

AsyncStatus

A PIAsynchStatus object for launching an asynchronous call, determining the progress of, or cancelling a lengthy call. [Optional]

Settings

The possible values in the array for Timestamps contained in the passed variant should conform to the following.  Note all timestamps in the array should be of the same type. In addition, the Timestamps argument can be a PIValues collection where the timestamps in each of the pivalue in the pivalues collection will be used as the time designator for the expression evaluation.

 

Remarks


Trappable Errors

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

Error Description
E_INVALIDARG Some of the function argument are not valid.
E_NOTIMPL This combination of the function arguments is not implemented at current PISDK version or not supported by this version of the PI Server.
PISDK_E_ERRCONVINPUT Problem converting input arguments to PI Server calling arguments.
E_ACCESSDENIED No read access to PI Server
PISDK_E_DATENOTONLINE Archive not online for specified time range
PISDK_E_EVENTSRETRIEVE Other calculation error from the PI Server
PISDK_E_ERRCONVOUTPUT Error converting PI Server result to PISDK result format

Enabling Operational Intelligence