This asynchronous function replaces 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 function 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 results are returned via the client's UpdateComplete event handler.
Syntax
| Visual Basic (Declaration) | |
|---|---|
Public Overloads Function Replace( _ ByVal transactionID As Integer, _ ByVal server() As Integer, _ ByVal timeStamps() As Date, _ ByVal dataValues() As Object, _ ByVal qualities() As Integer, _ ByRef errors As Integer(), _ ByRef cancelId As Integer _ ) As Integer | |
| C# | |
|---|---|
public int Replace( int transactionID, int[] server, DateTime[] timeStamps, object[] dataValues, int[] qualities, out int[] errors, out int cancelId ) | |
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.
- server
- The list of server item handles for the items to be replaced.
- timeStamps
- Array of DateTime time stamps for the new values.
- dataValues
- Array of structures which contain the item values.
- qualities
- Array of the quality flags of the new values. These are the Data Access Quality flags, not the HDA quality flags.
- errors
- OUT: Array of HRESULTs indicating whether the corresponding server handle was valid.
- cancelId
Return Value
S_OK, S_FALSE, E_NOTIMPL, E_INVALIDARG, E_FAILRequirements
Target Platforms: Windows 7/8/10, Windows Server 2008/2012/2016, .NET 4.x