IVdsVDisk::GetHostVolume-Methode (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Gibt einen Schnittstellenzeiger auf das Volumeobjekt für das Volume zurück, auf dem sich der virtuelle Datenträger befindet.

Syntax

HRESULT GetHostVolume(
  [out] IVdsVolume **ppVolume
);

Parameter

[out] ppVolume

Ein Zeiger auf eine Variable, die einen IVdsVolume-Schnittstellenzeiger für das Volume empfängt. Aufrufer müssen den Schnittstellenzeiger freigeben, wenn er nicht mehr benötigt wird, indem sie die IUnknown::Release-Methode aufrufen.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich abgeschlossen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vds.h
Bibliothek Uuid.lib

Weitere Informationen

IVdsVDisk