Admin Production ni-theme
Current Publication

GetCurrentCVIAbsoluteTime

LabWindows/CVI

GetCurrentCVIAbsoluteTime

int GetCurrentCVIAbsoluteTime (CVIAbsoluteTime *absoluteTime);

Purpose

Returns the current absolute time in National Instruments Binary Time Format.

Parameters

Output
Name Type Description
absoluteTime CVIAbsoluteTime 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

Example

Refer to utility\clock.cws for an example of using the GetCurrentCVIAbsoluteTime function.