Admin Production ni-theme
Current Publication

SubtractFromCVIAbsoluteTime

LabWindows/CVI

SubtractFromCVIAbsoluteTime

int SubtractFromCVIAbsoluteTime (CVIAbsoluteTime absoluteTime, CVITimeInterval interval, CVIAbsoluteTime *result);

Purpose

Subtracts a time interval value from an absolute time value and returns the resulting absolute time value.

Parameters

Input
Name Type Description
absoluteTime CVIAbsoluteTime Absolute time value in National Instruments Binary Time Format.
interval CVITimeInterval Time interval value in National Instruments Binary Time Format.
Output
Name Type Description
result CVIAbsoluteTime The result of the calculation, as an absolute time value in National Instruments Binary Time Format.

Return Value

Name Type Description
status int The result of the function call. Negative values represent errors.

The following table describes the results that this function returns.

Code Constant Description
0 or positive values Success.
–1 kCVITimeInvalidArgumentError An argument passed to the function is invalid.
–2 kCVITimeNullPointerError A NULL pointer was passed to the function instead of a valid memory address.
–3 kCVITimeOverflowError A numerical calculation resulted in an overflow.
–4 kCVITimeDateOutOfRangeError A time value passed to the function is not in the supported range.
–5 kCVITimeOperationFailedError The operation failed due to an unspecified system error.

Additional Information

Library: Utility Library

Include file: utility.h

LabWindows/CVI compatibility: LabWindows/CVI 9.0 and later