Admin Production ni-theme
Current Publication

SetSystemTime

LabWindows/CVI

SetSystemTime

int SetSystemTime (int hours, int minutes, int seconds);

Purpose

Sets the system time.

(Linux) This function is not supported.

Note    You must have system administrator status to use this function.
Caution  The Windows SDK also contains a function with the same name. Include windows.h before including utility.h to ensure that there are no compilation errors as a result of this naming conflict. Define the SDK_CONFLICT_PRIORITYSDK_CONFLICT_PRIORITY macro to force LabWindows/CVI to use the Windows SDK implementation of this function.

Parameters

Input
Name Type Description
hours int The hours component of the time.

Values: 0 to 23
minutes int The minutes component of the time.

Values: 0 to 59
seconds int The seconds component of the time.

You can specify only even numbers. If you specify an odd number of seconds, the number is rounded down.

Values: 0 to 58

Return Value

Name Type Description
result int The result of the call.

Code Description
0 Success.
-1 Operating system reported failure, probably because of an invalid parameter.

Additional Information

Library: Utility Library

Include file: utility.h

LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later