RetireExecutableHandle
- Updated2023-02-21
- 1 minute(s) read
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 | int | Executable handle you obtain from LaunchExecutableEx. |
Return Value
| Name | Type | Description | ||||||
| status | int | Result of the operation.
|
Additional Information
Library: Utility Library
Include file: utility.h
LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later
Examples
Refer to the following examples that use the RetireExecutableHandle function:
- udp\DNSResolver.cws
Open example - utility\launchexe.cws
Open example