RetireExecutableHandle

int RetireExecutableHandle (int executableHandle);

Purpose

Informs the LabWindows/CVI Utility Library that you no longer intend to use the handle you acquired from LaunchExecutableEx. When you call RetireExecutableHandle, the LabWindows/CVI Utility Library can reuse the memory allocated to keep track of the state of the executable.

When you launch several processes with LaunchExecutableEx but do not call RetireExecutableHandle on them, you might reach the limit for the maximum number of processes the system imposes. This happens even if the processes terminate; the program does not recognize that the processes have terminated until you call RetireExecutableHandle.

Parameters

Input
Name Type Description
executableHandle integer Executable handle you obtain from LaunchExecutableEx.

Return Value

Name Type Description
status integer Result of the operation.

Code Description
-1 Handle is invalid.
0 Success