Professional Edition only.
This method replaces the values and qualities in the history database at the specified timestamps for one or more items. If no value exists at the specified timestamp, the new value shall not be inserted; instead errors shall indicate an error. This method is intended to replace existing values at the specified timestamp; e.g., correct lab data that was improperly processed, but inserted into the history database. The serverHnd, timeStamps, dataValues and qualities are arrays of equal size. To replace the values for a number of different items at a single time, then timeStamps array would have the same time for each item. To replace 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 replaced and put the same ItemID in each element.
'Usage
Dim instance As AppPlugin
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.UpdateReplace(transactionID, serverHnd, timeStamps, dataValues, qualities, cancelID, errors)
public int UpdateReplace(
int ,
int[] ,
DateTime[] ,
object[] ,
int[] ,
out int ,
out int[]
)
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 replaced.
- 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.
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