IVMVirtualMachine::AddDVDROMDrive method

Article
05/31/2018

The AddDVDROMDrive method adds a new CD or DVD drive to the virtual machine.

Syntax

HRESULT AddDVDROMDrive(
  [in]  VMDriveBusType busType,
  [in]  long           busNumber,
  [in]  long           deviceNumber,
  [out] IVMDVDDrive    **dvdDrive
);

Parameters

busType [in]: Bus to attach the CD or DVD drive to.
busNumber [in]: Bus number to attach the CD or DVD drive to. For IDE, this number can be 0-1. DVDROM drives cannot be attached to the SCSI bus.
deviceNumber [in]: Device number to attach the CD or DVD drive to. For IDE, this number can be 0-1. DVDROM drives cannot be attached to the SCSI bus.
dvdDrive [out]: A new IVMDVDDrive object.

Return value

This method can return one of these values.

Return code	Description
S_OK	The operation was successful.
E_POINTER	dvdDrive is NULL.
E_INVALIDARG	busType, busNumber, or deviceNumber is invalid.
VM_E_VM_UNKNOWN	The configuration is unknown.
VM_E_VM_RUNNING	Virtual machine is running or saved.
VM_E_DRIVE_BUS_LOC_IN_USE	The specified bus location is in use.
VM_E_DRIVE_INVALID	Invalid drive specified.
DISP_E_EXCEPTION	An unexpected error has occurred.

Remarks

You can only add a new CD or DVD drive to a stopped virtual machine.

Examples

The following example adds a DVD drive to the secondary IDE controller as the primary device.

Set objVS = CreateObject("VirtualServer.Application")
Set objVM = objVS.FindVirtualMachine("Windows Server 2003")
Set objDVD = objVM.AddDVDROMDrive(0,1,0)

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