Admin Production ni-theme
Current Publication

SetFileTime

LabWindows/CVI

SetFileTime

int SetFileTime (char fileName[], int hours, int minutes, int seconds);

Purpose

Sets the last modification time of a file.

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
fileName char [] The pathname of the file for which to set the time.

If you specify an empty string "", SetFileTime sets the time of the file found by the most recent call to GetFirstFile or GetNextFile.
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 an even number of seconds. 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 File not found or directory in path not found.
-3 General I/O error occurred.
-4 Insufficient memory to complete the operation.
-5 Invalid time, or invalid path; for example, c:filename.
-6 Access denied.

Additional Information

Library: Utility Library

Include file: utility.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later