Admin Production ni-theme
Current Publication

TerminateExecutable

LabWindows/CVI

TerminateExecutable

int TerminateExecutable (int executableHandle);

Purpose

Terminates an executable if it has not already terminated.

This function calls TerminateProcess to terminate the process. DLLs loaded by the process being terminated are not given a chance to cleanup. Exit a process using the ExitProcess function rather than terminating the process using TerminateProcess.

Parameters

Input
Name Type Description
executableHandle int Executable handle acquired from LaunchExecutableEx.

Return Value

Name Type Description
status int Result of the operation.

Code Description
-1 Handle is invalid.
0 Handle is valid.

To determine if the function actually terminated the executable, use ExecutableHasTerminated.

Additional Information

Library: Utility Library

Include file: utility.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later

Example

Refer to utility\launchexe.cws for an example of using the TerminateExecutable function.