Name

Description

HRESULT
ListProcessesInGuest([in] LONG options,
                     [in] ICallback* jobDoneCallback,
                     [out,retval] IJob** listJob);

This function lists the running processes in the guest operating system.

Parameters

options

Must be 0.

jobDoneCallback

A callback function that will be invoked when the operation is complete.

listJob

Returns an IJob object that describes the state of this asynchronous operation.

Return Value

Remarks

• You must call before calling this function.
• Job::GetNumProperties() should be used to determine the number of results.
• Job::GetNthProperties() can be used to get each result.
• When the job is signaled, the following list of properties will be available

• VIX_PROPERTY_JOB_RESULT_ITEM_NAME: the process name
• VIX_PROPERTY_JOB_RESULT_PROCESS_ID: the process id
• VIX_PROPERTY_JOB_RESULT_PROCESS_OWNER: the process owner
• VIX_PROPERTY_JOB_RESULT_PROCESS_COMMAND: the process command line

Side Effects

Requirements

Example

Set job = vm.ListProcessesInGuest(0, Nothing)
err = job.WaitWithoutResults()
QuitIfError(err) 

numResults = job.GetNumProperties(VixCOM.Constants.VIX_PROPERTY_JOB_RESULT_ITEM_NAME)

Dim prop
ReDim prop(3)
' Populate the array of properties to request.
prop(0) = VixCOM.Constants.VIX_PROPERTY_JOB_RESULT_ITEM_NAME
prop(1) = VixCOM.Constants.VIX_PROPERTY_JOB_RESULT_PROCESS_ID
prop(2) = VixCOM.Constants.VIX_PROPERTY_JOB_RESULT_PROCESS_OWNER
prop(3) = VixCOM.Constants.VIX_PROPERTY_JOB_RESULT_PROCESS_COMMAND
for i=0 to numResults-1
   err = job.GetNthProperties(i, prop, results)
   QuitIfError(err)
   ' Unpack the results.
   name = results(0)
   pid = CStr(results(1))
   ownder = results(2)
   cmd = results(3)
   WScript.Echo(name & " (" & pid & "): " & owner & ", " & cmd)
Next