IVMVirtualMachine::Memory property

[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/value	Meaning
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

Requirement	Value
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