IVMVirtualMachine::AddHardDiskConnection-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Fügt dem virtuellen Computer (VM) eine neue Festplattenverbindung hinzu.

Syntax

HRESULT AddHardDiskConnection(
  [in]          BSTR                  hardDiskPath,
  [in]          long                  busNumber,
  [in]          long                  deviceNumber,
  [out, retval] IVMHardDiskConnection **hardDiskConnection
);

Parameter

hardDiskPath [in]

Der vollständige Pfad der virtuellen Festplatte (VHD)-Datei, die eine Verbindung hergestellt werden soll.

busNumber [in]

Der Bus, an den das Laufwerk angeschlossen wird.

Wert Bedeutung
0
 Das Laufwerk wird an den ersten Bus angeschlossen.
1
 Das Laufwerk wird an den zweiten Bus angeschlossen.

deviceNumber [in]

Das Gerät, an das das Laufwerk angeschlossen wird.

Wert Bedeutung
0
 Das Laufwerk wird an das erste Gerät im Bus angeschlossen.
1
 Das Laufwerk wird an das zweite Gerät im Bus angeschlossen.

hardDiskConnection [out, retval]

Ein IVMHardDiskConnection-Objekt .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0
 Der Vorgang wurde durchgeführt.
E_POINTER
0x80004003
 Der hardDiskConnection-Parameter ist NULL.
E_INVALIDARG
0x80000003
 Ein hardDiskPath-Parameter ist NULL , oder der busNumber - oder deviceNumber-Parameter ist ungültig.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 Das System kann die durch den hardDiskPath-Parameter angegebene Datei nicht finden.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Der vom HardDiskPath-Parameter angegebene Pfad kann vom System nicht gefunden werden.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Der hardDiskPath-Parameter enthält ein ungültiges Zeichen (eines von "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Der hardDiskPath-Parameter gibt einen leeren oder relativen Pfad an. Ein absoluter Pfad ist erforderlich.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Der vom hardDiskPath-Parameter angegebene Pfad ist zu lang. Der Pfad muss weniger als 260 Zeichen lang sein.
VM_E_VM_UNKNOWN
0xA0040207
 Die Konfiguration ist unbekannt.
VM_E_VM_RUNNING_OR_SAVED
0xA004020B
 Der virtuelle Computer befindet sich in einem ausgeführten oder gespeicherten Zustand.
VM_E_DRIVE_BUS_LOC_IN_USE
0xA00400503
 Der angegebene Busstandort wird verwendet.
VM_E_INVALID_HD_FILE
0xA0040682
 Die VHD ist größer als 127 GB und kann nicht mit dem IDE-Bus verbunden werden.
VM_E_UNSUPPORTED_HD_DISK_TYPE
0xA00400686
 Der hardDiskPath-Parameter bezieht sich auf eine verknüpfte VHD oder eine differenzierende VHD zu einer verknüpften VHD. Verknüpfte VHDs können nicht an virtuelle Computer angefügt werden.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 Die angegebene VHD ist bereits mit einem anderen Busspeicherort für diesen virtuellen Computer verbunden.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Sie können nur eine neue Festplattenverbindung zu einem angehaltenen virtuellen Computer hinzufügen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Nicht unterstützt
Ende des Supports (Client)
 Windows 7
Produkt
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine ist definiert als f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Siehe auch

IVMVirtualMachine