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 InsertAnnotations( _ ByVal transactionId As Integer, _ ByVal server() As Integer, _ ByVal timeStamps() As Date, _ ByVal annotationValues() As OPCHDAannotation, _ ByRef cancelID As Integer, _ ByRef errors As Integer() _ ) As Integer | |
| C# | |
|---|---|
public int InsertAnnotations( int transactionId, int[] server, DateTime[] timeStamps, OPCHDAannotation[] annotationValues, out int cancelID, out int[] errors ) | |
Parameters
- transactionId
- 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_FAILRequirements
Target Platforms: Windows 7/8/10, Windows Server 2008/2012/2016, .NET 4.x