Edit

Share via

IVMVirtualMachine::ChassisSerialNumber property

  • Article

[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 chassis serial number.

This property is read/write.

Syntax

HRESULT put_ChassisSerialNumber(
  [in]          BSTR chasisSerialNumber
);

HRESULT get_ChassisSerialNumber(
  [out, retval] BSTR *chassisSerialNumber
);

Property value

Specifies the chassis serial number.

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 greater than 32 characters, an empty string, or not valid.
VM_E_VM_UNKNOWN
0xA0040207
 The configuration is unknown.
VM_E_VM_RUNNING_OR_SAVED
0xA004020B
 The virtual machine is in a running or saved state.
DISP_E_EXCEPTION
0x80020009
 An unexpected error has occurred.

Remarks

This property will not contain valid information until after the virtual machine has started up for the first time. An empty string will be returned if it is read before the initial startup.

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