Chapter 8 Utility Library
© National Instruments Corporation 8-61 LabWindows/CVI Standard Libraries
Under UNIX, if the arguments to RenameFile specify files on different file systems,
RenameFile copies the source to the target and then deletes the source file.
RetireExecutableHandle
int status = RetireExecutableHandle (int executableHandle);
Purpose
Informs the Utility Library that you no longer intend to use the handle acquired from
LaunchExecutableEx. When you call this function the Utility Library can reuse the
memory allocated to keep track of the state of the executable.
Under UNIX, if the process has terminated, the system removes the process from the list of
processes. This keeps the system from reaching the limit on the total number of processes under
execution by a single user which the system imposes.
Parameters
Input executableHandle integer The executable handle acquired from
LaunchExecutableEx.
-1 = handle is invalid.
0 = success.
Return Value
status integer Result of operation.
RoundRealToNearestInteger
long n = RoundRealToNearestInteger (double inputRealNumber);
Purpose
Rounds its floating-point argument and returns the result as a long integer. A value with a
fractional part of exactly 0.5 is rounded to the nearest even number. This function is encountered
in translations.
Parameter
Input inputRealNumber Double-precision.