Share via


IVMGuestOS::InstallAdditions method

The InstallAdditions method locates and installs the latest Additions into the guest operating system.

Syntax

HRESULT InstallAdditions();

Parameters

This method has no parameters.

Return value

This method can return one of these values.

Return code Description
S_OK
The operation was successful.
VM_E_VM_NOT_RUNNING
The virtual machine is not running.
VM_E_VM_UNKNOWN
The virtual machine could not be found.
VM_E_DRIVE_INVALID
The virtual machine does not have an empty DVD drive.
VM_E_MEDIA_UNMOUNT_FAIL
The attempt to unmount the media from the virtual machine DVD drive failed.
DISP_E_EXCEPTION
An unexpected error occurred.

Remarks

This method attempts to locate the ISO image for the latest Additions and attach it to a DVD drive in the virtual machine. If the virtual machine is booted and running a Windows-based guest operating system, Windows will autorun the Additions installer. If the virtual machine is not completely booted, or the guest operating system has autorun disabled, or the guest operating system is not Windows-based, you will need to manually launch the Additions installer. The virtual machine must be running and contain an empty DVD drive when this method is invoked. Virtual Server 1.1 only supports Windows Additions. Linux and OS/2 Additions are not available.

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

See also

IVMGuestOS