OPC Historian .NET Server Toolkit Reference
ReadRaw(DateTime,DateTime,Int32,Boolean,Int32[],OPCHDAItem[],Int32[]) Method

The beginning of the history period to be read.
The end of the history period to be read.
The maximum number of values returned for any item over the time range. If only one time is specified, the time range must extend to return this number of values.
True if bounding values should be returned.
The list of server item handles for the items to be read.
Array of objects in which the item values are returned. The order of the objects in the array shall be the same as the order of the server item handles.
Array of HRESULTs indicating the success of the individual item reads. The errors correspond to the handles passed in phServer. This indicates whether the read succeeded in obtaining a defined value, quality and timestamp. NOTE that any FAILED error code indicates that the corresponding OPCHDA_ITEM struct is undefined.
Synchronous ReadRaw.
This method reads the values, qualities, and timestamps from the history database for the specified time domain for one or more items. When bBounds is TRUE, the bounding values for the time domain are returned. This method is intended for use by clients wanting the actual data saved within the historian. The actual data may be compressed or may be all data collected for the item depending on the historian and the storage rules invoked when the item values were saved. The optional bounding values are provided to allow clients to interpolate values for the start and end times when trending the actual data on a display.
Syntax
'Usage
 
Dim instance As AppPlugin
Dim startTime As Date
Dim endTime As Date
Dim numValues As Integer
Dim bounds As Boolean
Dim serverHandles() As Integer
Dim itemValues As OPCHDAItem()
Dim errors As Integer()
Dim value As Integer
 
value = instance.ReadRaw(startTime, endTime, numValues, bounds, serverHandles, itemValues, errors)
public int ReadRaw( 
   DateTime startTime,
   DateTime endTime,
   int numValues,
   bool bounds,
   int[] serverHandles,
   out OPCHDAItem[] itemValues,
   out int[] errors
)

Parameters

startTime
The beginning of the history period to be read.
endTime
The end of the history period to be read.
numValues
The maximum number of values returned for any item over the time range. If only one time is specified, the time range must extend to return this number of values.
bounds
True if bounding values should be returned.
serverHandles
The list of server item handles for the items to be read.
itemValues
Array of objects in which the item values are returned. The order of the objects in the array shall be the same as the order of the server item handles.
errors
Array of HRESULTs indicating the success of the individual item reads. The errors correspond to the handles passed in phServer. This indicates whether the read succeeded in obtaining a defined value, quality and timestamp. NOTE that any FAILED error code indicates that the corresponding OPCHDA_ITEM struct is undefined.

Return Value

HRESULTS success/error code.
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

AppPlugin Class
AppPlugin Members
Overload List

 

 


Copyright © 2004-2019 Advosol Inc. All rights reserved

Send Feedback