OPC Historian .NET Server Toolkit Reference
UpdateInsertReplace(Int32,Int32[],DateTime[],Object[],Int32[],Int32,Int32[]) Method

An identifier created by the client and passed to the server in this call. The server shall return this identifier along with the results of this call.
The list of server item handles for the items to be edited.
Array of the time stamps for the new values.
Array of objects which contain the new item values.
Array of the quality flags of the new values. These are the Data Access Quality flags, not the HDA quality flags.
Place to return a Server generated ID to be used in case the operation needs to be canceled.
Array of HRESULTs indicating whether the corresponding server handle was valid.
Professional Edition only.
This method inserts or replaces values and qualities in the history database for the specified timestamps for one or more items. If the item has a value at the specified timestamp, the new value and quality will replace the old one. If there is no value at that timestamp, the method will insert the new data. The method runs to completion before returning. This method is intended to unconditionally insert/replace values and qualities; e.g., correction of values for bad sensors. The serverHnd, timeStamps, dataValues and qualities are arrays of equal size. To set values and qualities for a number of different items at a single time, then ftTimeStamp array would have the same time for each item. To set a stream of values, timestamps and qualities for a single item, set the size of the item array to the number of values to be inserted/replaced and put the same ItemID in each element. S_OK as a errors return code for an individual value is allowed when the HDA server is unable to say whether there was already a value at that timestamp. If the HDA server can determine whether the new value replaces a value that was already there, it should use OPC_S_INSERTED or OPC_S_REPLACED to return that information.
Syntax
'Usage
 
Dim instance As IAppPlugin
Dim transactionID As Integer
Dim serverHnd() As Integer
Dim timeStamps() As Date
Dim dataValues() As Object
Dim qualities() As Integer
Dim cancelID As Integer
Dim errors As Integer()
Dim value As Integer
 
value = instance.UpdateInsertReplace(transactionID, serverHnd, timeStamps, dataValues, qualities, cancelID, errors)
int UpdateInsertReplace( 
   int transactionID,
   int[] serverHnd,
   DateTime[] timeStamps,
   object[] dataValues,
   int[] qualities,
   out int cancelID,
   out int[] errors
)

Parameters

transactionID
An identifier created by the client and passed to the server in this call. The server shall return this identifier along with the results of this call.
serverHnd
The list of server item handles for the items to be edited.
timeStamps
Array of the time stamps for the new values.
dataValues
Array of objects which contain the new item values.
qualities
Array of the quality flags of the new values. These are the Data Access Quality flags, not the HDA quality flags.
cancelID
Place to return a Server generated ID to be used in case the operation needs to be canceled.
errors
Array of HRESULTs indicating whether the corresponding server handle was valid.

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

IAppPlugin Interface
IAppPlugin Members
Overload List

 

 


Copyright © 2004-2019 Advosol Inc. All rights reserved

Send Feedback