# Name

VixVM_KillProcessInGuest

# Description

    VixHandle
    VixVM_KillProcessInGuest(VixHandle vmHandle,
                             uint64 pid,
                             int options,
                             VixEventProc *callbackProc,
                             void *clientData);

This function terminates a process in the guest operating system.

# Parameters

vmHandle
  Identifies a virtual machine. Call VixVM_Open() to create a virtual machine handle.
pid
  The ID of the process to be killed.
options
  Must be 0.
callbackProc
  A callback function that will be invoked when the operation is complete.
clientData
  A parameter that will be passed to the callbackProc function.

# Return Value

VixHandle. A job handle that describes the state of this asynchronous operation.

# Remarks

- You must call VixVM_LoginInGuest() 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

vix.h, since VMware Workstation 6.0
Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

Copyright (C) 2007-2018 VMware, Inc. All rights reserved.