IVMAccountant::CPUUtilizationHistory property

The CPUUtilizationHistory property contains an array of percentage values that specify the recent CPU use of this virtual machine.

This property is read-only.

Syntax

HRESULT get_CPUUtilizationHistory(
  [out] VARIANT *percentageUtilization
);

VB
`VMAccountant.CPUUtilizationHistory( _ ByRef percentageUtilization _ )`

Property value

The recent CPU use of this virtual machine. This use data is returned as a Byte array of 60 elements that represent the percentage of CPU use at each second over the past minute.

This property value is read-only.

Error codes

Name	Meaning
S_OK	The operation was successful.
E_POINTER	percentageUtilization is NULL.
S_FALSE	The virtual machine is not running (array is still returned with all 60 values set to 0 in this case).
DISP_E_EXCEPTION	An unexpected error occurred.

Examples

The following example prints the CPUUtilizationHistory property information for each virtual machine.

Set objVS = CreateObject("VirtualServer.Application")
set colVMs = objVS.VirtualMachines

For Each objVM in colVMS
    Set colAccountants = objVM.Accountant
        Wscript.Echo "Virtual machine: " & objVM.Name
        i = 1
        Wscript.Echo "CPU utilization history:"
        For Each intCPUUtilization in colAccountants.CPUUtilizationHistory
            Wscript.Echo vbTab & i & " -- " & intCPUUtilization
            i = i + 1
        Next
        Wscript.Echo
Next

Requirements


Product	Microsoft Virtual Server 2005 onWindows Server 2003
Download	Microsoft Virtual Server 2005 R2 SP1 Update onWindows Server 2008orWindows Server 2003
Header	VsComInterfaces.h

Share via