Export (0) Print
Expand All

IVMVirtualMachine::Memory property

Windows Virtual PC

[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]

Retrieves and sets the amount of physical memory in the virtual machine, in megabytes.

This property is read/write.

Syntax


HRESULT put_Memory(
  [in]           long megabytesOfMemory
);

HRESULT get_Memory(
  [out, retval]  long *megabytesOfMemory
);

Property value

Specifies the amount of physical memory, in megabytes.

Error codes

Name/valueMeaning
S_OK
0

The operation was successful.

E_POINTER
0x80004003

The parameter is NULL.

E_INVALIDARG
0x80000003

The parameter is not valid or is out of range.

VM_E_VM_UNKNOWN
0xA0040207

The configuration is unknown.

VM_E_PREF_NOT_FOUND
0xA0040300

The preference was not found.

VM_E_PREF_VM_ACTIVE
0xA0040302

The virtual machine is running or saved.

DISP_E_EXCEPTION
0x80020009

An unexpected error has occurred.

Remarks

The amount of physical memory in a virtual machine must be at least 4 MB. The upper limit on memory depends on the host configuration, but can be at most 3,712 MB.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

None supported

End of client support

Windows 7

Product

Windows Virtual PC

Header

VPCCOMInterfaces.h

IID

IID_IVMVirtualMachine is defined as f7092aa1-33ed-4f78-a59f-c00adfc2edd7

See also

IVMVirtualMachine

 

 

Community Additions

ADD
Show:
© 2014 Microsoft