IVdsService::QueryUnallocatedDisks-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 ein Enumerationsobjekt zurück, das eine Liste der nicht zugeordneten Datenträger enthält, die von VDS verwaltet werden.

Syntax

HRESULT QueryUnallocatedDisks(
  [out] IEnumVdsObject **ppEnum
);

Parameter

[out] ppEnum

Die Adresse eines IEnumVdsObject-Schnittstellenzeigers , der verwendet werden kann, um die Datenträger als Datenträgerobjekte aufzulisten. Weitere Informationen finden Sie unter Arbeiten mit Enumerationsobjekten. Aufrufer müssen die Schnittstelle und jedes der Datenträgerobjekte freigeben, wenn sie nicht mehr benötigt werden, 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/-wert	BESCHREIBUNG
S_OK	Die Enumeration wurde erfolgreich zurückgegeben.
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor der Dienst die Initialisierung abgeschlossen hat, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn bei der Initialisierung ein Fehler auftritt, wird dieser Fehler zurückgegeben.

Hinweise

Ein nicht zugeordneter Datenträger wird von keinem Anbieter beansprucht. Es kann informationen zum MBR- oder GPT-Partitionsformat enthalten oder auch nicht. Häufig handelt es sich um einen nicht initialisierten Datenträger. Wenn der Datenträger status VDS_DS_ONLINE oder VDS_DS_OFFLINE ist, wird der Datenträger nicht zugeordnet und nicht initialisiert. Wenn es sich um VDS_DS_UNKNOWN, VDS_DS_NOT_READY, VDS_DS_FAILED oder VDS_DS_MISSING handelt, ist es nicht zugeordnet, aber der VDS-Dienst kann nicht ermitteln, ob er initialisiert ist, möglicherweise aufgrund von Problemen mit dem Datenträger.

Um den datenträger status zu bestimmen, sehen Sie sich den status Member der VDS_DISK_PROP- oder VDS_DISK_PROP2-Struktur für den Datenträger an.

Wenn der Datenträger status VDS_DS_ONLINE ist, kann der Datenträger einem Paket hinzugefügt werden.

Wenn der Datenträger status VDS_DS_OFFLINE ist, versuchen Sie, den Datenträger online zu schalten, indem Sie IVdsDiskOnline::Online aufrufen. Wenn der Aufruf der Online-Methode erfolgreich ist, kann der Datenträger einem Paket hinzugefügt werden. Wenn der Onlineaufruf fehlschlägt, kann der Datenträger nicht verwendet werden.

Anforderungen

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

Weitere Informationen

IEnumVdsObject

IVdsService