IVdsIscsiTarget::QueryAssociatedLuns-Methode (vds.h)

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

Gibt eine Enumeration der LUNs zurück, die dem Ziel zugeordnet sind.

Syntax

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

Parameter

[out] ppEnum

Die Adresse eines IEnumVdsObject-Schnittstellenzeigers , der zum Aufzählen der LUNs als LUN-Objekte verwendet werden kann. Weitere Informationen finden Sie unter Arbeiten mit Enumerationsobjekten. Aufrufer müssen die Schnittstelle und die einzelnen LUN-Objekte 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 makros HRESULT_FROM_WIN32 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 der zugeordneten LUNs wurde erfolgreich zurückgegeben. Wenn das Ziel keine zugeordneten LUNs aufweist, ist die Enumeration leer.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Der Cache des Anbieters ist beschädigt. Dies weist auf ein Software- oder Kommunikationsproblem innerhalb eines Anbieters hin, der Informationen zu den angefügten Geräten zwischenspeichert. Der Aufrufer kann die IVdsHwProvider::Reenumerate-Methode gefolgt von der IVdsHwProvider::Refresh-Methode verwenden, um den Cache wiederherzustellen.
VDS_E_OBJECT_DELETED 0x8004240BL	Das Zielobjekt ist nicht mehr vorhanden.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Ein weiterer Vorgang wird ausgeführt; Dieser Vorgang kann erst fortgesetzt werden, wenn die vorherigen Vorgänge abgeschlossen sind.

Hinweise

LUNs werden dem Ziel zugeordnet, indem die IVdsLunIscsi::AssociateTargets-Methode aufgerufen wird.

Anforderungen

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

Weitere Informationen

IEnumVdsObject

IVdsIscsiTarget

IVdsLun::SetMask