IVdsSubSystem::QueryLuns-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 eine Enumeration von LUNs zurück, die im Subsystem aufgetaucht sind. Diese Methode gilt nur für Hardwareanbieterobjekte.

Syntax

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

Parameter

[out] ppEnum

Die Adresse eines IEnumVdsObject-Schnittstellenzeigers , der verwendet werden kann, um die LUNs als LUN-Objekte aufzulisten. Weitere Informationen finden Sie unter Arbeiten mit Enumerationsobjekten. Aufrufer müssen die Schnittstelle und jedes LUN-Objekt 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	Gibt die Enumeration der LUNs im Subsystem zurück. Wenn das Subsystem über keine LUNs verfügt, ist die Enumeration leer.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Dieser Rückgabewert signalisiert ein Software- oder Kommunikationsproblem innerhalb eines Anbieters, der Informationen zum Array zwischenspeichert. Verwenden Sie die IVdsHwProvider::Reenumerate-Methode gefolgt von der IVdsHwProvider::Refresh-Methode , um den Cache wiederherzustellen.
VDS_E_OBJECT_DELETED 0x8004240BL	Das Subsystemobjekt ist nicht mehr vorhanden.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Das Subsystem ist fehlerhaft und kann den angeforderten Vorgang nicht ausführen.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Ein weiterer Vorgang wird ausgeführt. Dieser Vorgang kann erst fortgesetzt werden, wenn der vorherige Vorgang oder die vorherigen Vorgänge abgeschlossen sind.

Hinweise

Die IEnumVdsObject-Schnittstelle enthält alle LUNs im Subsystem, unabhängig von der LUN-Maskierung.

Implementierer müssen ein leeres Enumerationsobjekt für jedes Subsystem mit null LUNs zurückgeben.

Wenn diese Methode in zwei separaten Threads aufgerufen wird, die gleichzeitig ausgeführt werden, können die Ergebnisse inkonsistent sein. Wenn sie in einem Thread aufgerufen wird, während eine Methode wie IVdsLun::D elete in einem anderen Thread aufgerufen wird, der gleichzeitig ausgeführt wird, kann das Ergebnis eine Zugriffsverletzung des Anbieters sein. Der Hardwareanbieter ist für die Serialisierung dieses Abfragevorgangs bei Bedarf verantwortlich, um solche Synchronisierungsprobleme zu minimieren.

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

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsSubSystem