OPCHDA.NET Reference Manual
Insert(Int32,Int32[],DateTime[],OPCHDAannotation[],Int32,Int32[]) Method
See Also  Send Feedback
OpcHDAWrapperUA.Net4 Assembly > OPCHDA.NET Namespace > OpcHDAServer Class > Insert Method : Insert(Int32,Int32[],DateTime[],OPCHDAannotation[],Int32,Int32[]) Method

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 annotation items to be inserted.
timeStamps
Array of time stamps for the annotations to be inserted.
annotationValues
Array of structures containing the annotation values to be inserted.
cancelID
OUT: Place to return a Server generated ID to be used in case the operation needs to be canceled.
errors
OUT: Array of HRESULTs indicating the success of the individual annotation inserts. The errors correspond to the handles passed in server.

Glossary Item Box

This asynchronous function inserts annotations into the history database. This function is intended to insert annotations by users to document observations for a value at a specified timestamp.

The results are returned via the client's InsertAnnotations event handler.

Syntax

Visual Basic (Declaration) 
Public Overloads Function Insert( _
   ByVal transactionID As Integer, _
   ByVal server() As Integer, _
   ByVal timeStamps() As Date, _
   ByVal annotationValues() As OPCHDA.NET.OPCHDAannotation, _
   ByRef cancelID As Integer, _
   ByRef errors As Integer() _
) As Integer
C# 
public int Insert( 
   int transactionID,
   int[] server,
   DateTime[] timeStamps,
   OPCHDA.NET.OPCHDAannotation[] annotationValues,
   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.
server
The list of server item handles for the annotation items to be inserted.
timeStamps
Array of time stamps for the annotations to be inserted.
annotationValues
Array of structures containing the annotation values to be inserted.
cancelID
OUT: Place to return a Server generated ID to be used in case the operation needs to be canceled.
errors
OUT: Array of HRESULTs indicating the success of the individual annotation inserts. The errors correspond to the handles passed in server.

Return Value

S_OK, S_FALSE, E_NOTIMPL, E_INVALIDARG, E_FAIL

Requirements

Target Platforms: Windows 7/8/10, Windows Server 2008/2012/2016, .NET 4.x

See Also

Copyright © 2002-2018 Advosol Inc. All Rights Reserved.