GETARCHARR_TO_CNT archIdent, _retCNTHandle, pageSize, timeFromIdent_TmA, timeToIdent_TmA, stepIdent_Int, maxValsIdent_Int, statusIdent_Int[, archivInstance_Int] |
archIdent | in | Reference to one value of historical value,
reference to object or
item identifier of Structured variable type object
(note: values of object or item must be archived). Warning: If the parameter is the reference to an object archived several times, there is not specified which one of the historical objects is to be used. |
retCNTHandle | out | Variable which will contain the identifier of data container after the successful loading. |
pageSize | out | Required size of one page. |
timeFromItemIdent_TmA | in | Identifier of AbsTime type for the interval beginning. |
timeToItemIdent_TmA | in | Identifier of AbsTime type for the interval end. |
stepIdent | in | Identifier of Int type - time step for the oversampling of values in the archive. |
maxValsIdent_Int | in | Maximal number of values. If more values is in the required interval, they will be trimmed and the action returns the warning _ERR_MORE_DATA in the identifier statusIdent_Int. |
statusIdent_Int | out | Action success. |
archivInstance_Int | in | Optional identifier of Int type - identification of archive instance. If the parameter is not defined, the value 0 will replace it. |
timeFromIdent_TmA
to
timeToIdent_TmA
with the steps stepIdent_Int
(given in seconds). Maximal number of
values is given by the identifier maxValsIdent_Int
.If the parameter archIdent is
the reference to an object of Historical
value type,
the action performance is described above. If the parameter is the reference
to an object (not of Historical value
type) or a structured variable item that is not of Object
type, the system is attempting to find an object of
Historical value type that archives
values of the object (item).
If the parameter archIdent is the
reference to a structured variable item that is of Object
type, the item "points" to an object in the system. If the object is of
Historical value type, the action will
read data from it. If it is not, the system is attempting to find an object
of Historical value type that archives
values of the object.
The return
code statusIdent_Int
can get one of the following values:
maxValsIdent_Int
within given intervalThe error _ERR_MORE_DATA has only informative character and the required
number of data is available. If the value of the identifier stepIdent_Int
= 0, then values from the given interval are not be oversampled.
Value of parameter archivInstance_Int defines the instance of archive which executes the request. If the parameter is not defined (or the value is 0), the active instance of archive will execute the request.
E.GetArch, H.SingleStorage, SD.ArchVal, SD.ArchValOne, SD.ArchValOneBool