Name

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

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

Requirements