This method inserts values and qualities into the history database at the specified timestamps for one or more items. If a value exists at the specified timestamp, the new value shall not be inserted; instead errors shall indicate an error. This method is intended to insert new values at the specified timestamps; e.g., the insertion of lab data to reflect the time of data collection. The serverHnd, timeStamps, dataValues and qualities are arrays of equal size. To insert a value for a number of different items at a single time, then timeStamp array would have the same time for each item. To insert 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 and put the same ItemID in each element.
Syntax
| Visual Basic (Declaration) | |
|---|---|
Overloads Function UpdateInsert( _ ByVal transactionID As Integer, _ ByVal serverHnd() As Integer, _ ByVal timeStamps() As Date, _ ByVal dataValues() As Object, _ ByVal qualities() As Integer, _ ByRef cancelID As Integer, _ ByRef errors As Integer() _ ) As Integer | |
| C# | |
|---|---|
int UpdateInsert( 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 inserted.
- 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 XP Professional, Windows Server 2003 family, Windows Vista, Windows 7, Windows Server 2008 family