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.
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.Target Platforms: Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows 7, Windows Server 2008 family