uaPLUS Reference
InsertAnnotations(Int32,Int32[],DateTime[],AnnotationDef[],Int32,Int32[]) Method
See Also  Send Feedback
I_HDAPlugin Namespace > IAppPlugin Interface > InsertAnnotations Method : InsertAnnotations(Int32,Int32[],DateTime[],AnnotationDef[],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.
serverHnd
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 objects containing the annotation values to be inserted.
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.

Glossary Item Box

Professional Edition only.
This method inserts annotations into the history database. This method is intended to insert annotations by users to document observations for a value at a specified timestamp.

Syntax

Visual Basic (Declaration) 
Overloads Function InsertAnnotations( _
   ByVal transactionID As Integer, _
   ByVal serverHnd() As Integer, _
   ByVal timeStamps() As Date, _
   ByVal annotationValues() As AnnotationDef, _
   ByRef cancelID As Integer, _
   ByRef errors As Integer() _
) As Integer
C# 
int InsertAnnotations( 
   int transactionID,
   int[] serverHnd,
   DateTime[] timeStamps,
   AnnotationDef[] 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.
serverHnd
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 objects containing the annotation values to be inserted.
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

See Also

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