DeleteAtTime method (C++)

To delete the values and qualities in the history database for the specified time stamps for one or more items from a history sample after it has been written to the DeltaV Continuous Historian database using the Insert method, use the standard DeleteAtTime method for the IOPCHDA_SyncUpdate interface in a C++ program; for additional information about the following syntax, refer to section 4.4.4.6 in OPC Historical Data Access Specification Version 1.20:

HRESULT DeleteAtTime(
        [in] DWORD dwNumItems,
        [in, size_is(dwNumItems)] OPCHANDLE *phServer,
        [in, size_is(dwNumItems)] FILETIME *ftTimeStamps,
        [out, size_is(, dwNumItems)] HRESULT **ppErrors);

Parameter	Description
`dwNumItems`	The number of items to be deleted.
`phServer`	The list of OPC HDA server item handles for the items to be deleted.
`ftTimeStamps`	An array of the time stamps for the values to be deleted.
`ppErrors`	An array of HRESULTs indicating the success of the individual item deletes. The errors correspond to the handles passed in `phServer`. This indicates whether deleting the data succeeded.

Important

The DeleteAtTime method cannot be used to remove a history tag created with the CreateTags method for the item to be deleted from the history database.