OPC Historian .NET Server Toolkit Reference
InsertAnnotations(Int32,Int32[],DateTime[],AnnotationDef[],Int32,Int32[]) Method

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.
The list of server item handles for the annotation items to be inserted.
Array of time stamps for the annotations to be inserted.
Array of objects containing the annotation values to be inserted.
Place to return a Server generated ID to be used in case the operation needs to be canceled.
Array of HRESULTS indicating whether the corresponding server handle was valid.
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
'Usage
 
Dim instance As AppPlugin
Dim transactionID As Integer
Dim serverHnd() As Integer
Dim timeStamps() As Date
Dim annotationValues() As AnnotationDef
Dim cancelID As Integer
Dim errors As Integer()
Dim value As Integer
 
value = instance.InsertAnnotations(transactionID, serverHnd, timeStamps, annotationValues, cancelID, errors)
public 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 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

See Also

Reference

AppPlugin Class
AppPlugin Members
Overload List

 

 


Copyright © 2004-2019 Advosol Inc. All rights reserved

Send Feedback