IVMSCSIController::Configure method

The Configure method configures the SCSI controller to be used on an independent or on a shared bus.

Syntax

HRESULT Configure(
  [in] VARIANT_BOOL isBusShared,
  [in] long         SCSIID
);

Parameters

isBusShared [in]

Set to TRUE to put the SCSI controller on a shared bus. The SCSI controller is on an independent bus by default. To support clustering, set isBusShared to TRUE and SCSIID to 6.

SCSIID [in]

The SCSI ID of the SCSI controller. This can be set to either 6 or 7. The SCSI ID is 7 by default. To support clustering, set isBusShared to TRUE and SCSIID to 6.

Return value

This method can return one of these values.

This method supports standard return values, as well as the following. For information on Virtual Server specific return values not listed below, see HRESULT Codes Specific to the Virtual Server.

Return code Description
S_OK
The operation was successful.
E_INVALIDARG
The SCSI ID for the controller is not 6 or 7.
VM_E_VM_UNKNOWN
The virtual machine for this SCSI controller does not exist.
VM_E_PREF_NOT_FOUND
The SCSI controller does not exist.
DISP_E_EXCEPTION
An unexpected error occurred.

Remarks

SCSI controllers which are not shared use the default SCSI ID of 7.

When virtual machines are clustered, the respective SCSI controllers of each virtual machine is put on a shared SCSI bus. In this scenario, the controllers need to have unique IDs on the bus. The SCSI controller on the shared bus is normally set to an ID of 6.

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

IVMSCSIController