Name
VMKillProcessInGuest
Description
$err = VMKillProcessInGuest($vmHandle,
$pid,
$options);
This function terminates a process in the guest operating system.
Parameters
- vmHandle
-
Identifies a virtual machine. Call VMOpen() to create a virtual machine handle.
- pid
-
The ID of the process to be killed.
- options
-
Must be 0.
Return Value
$err. The error code returned by the operation. For returned values, see Topics > Error Codes.
Remarks
- You must call VMLoginInGuest() before calling this function.
- Depending on the behavior of the guest operating system, there may be
a short delay after the job completes before the process truly disappears.
- Because of differences in how various Operating Systems handle process
IDs, Vix may return either VIX_E_INVALID_ARG or VIX_E_NO_SUCH_PROCESS for
invalid process IDs.
Side Effects
None.
Requirements
use VMware::Vix::Simple;
use VMware::Vix::API::Constants;
since VMware Workstation 6.0
Minimum Supported Guest OS: Microsoft Windows NT Series, Linux