This function sends values to the snapshot and archive for an array of points. This function executes scaling, filtering, and compression as required.

C format

int32 pisn_putsnapshots(

int32 PIPTR * pt

float PIPTR * rval,

int32 PIPTR * istat,

int32 PIPTR * timedate,

int32 PIPTR * error,

int32 count );



System error




Access denied


pt (passed)

Array of point numbers

rval (passed)

Array of values in engineering units for real type points For integer points and digital points, rval is ignored.

istat (passed)

Array of statuses for real type points and values for integer and digital points. For real points, istat should be zero unless the point is bad. If the point is bad, istat should contain the status code which corresponds to the appropriate string in the digital state table. The code may be positive or negative. See the discussion in Sending and Retrieving Values from PI.

timedate (passed)

Array of time stamps. If timedate is zero, the system time and date are used.

error (returned)

Array of error values

  0 Success

 -1 Point does not exist

 -8 Time is after the current time or less than 0

 -9 Illegal status or integer value

 -10401  No write access - secure object (UNIX or NT archives only)

count (passed)

Count is set to the number of points passed in the array.

Usage Notes

Enabling Operational Intelligence