Freigeben über


IVdsIscsiTarget::QueryPortalGroups-Methode (vds.h)

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

Gibt eine Aufzählung der iSCSI-Portalgruppen innerhalb des Ziels zurück.

Syntax

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

Die Parameter

[out] ppEnum

Die Adresse eines IEnumVdsObject-Schnittstellenzeigers , der zum Aufzählen der Portalgruppen als Portalgruppenobjekte verwendet werden kann. Weitere Informationen finden Sie unter Arbeiten mit Enumerationsobjekten. Aufrufer müssen die Schnittstelle und jedes der Portalgruppenobjekte 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. Sie kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32 Makros zurückgeben. Fehler können von VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Mögliche Rückgabewerte sind:

Zurückgeben von Code/Wert Description
S_OK
Die Aufzählung von Portalgruppen wurde erfolgreich zurückgegeben. Wenn das Ziel keine Portalgruppen enthält, 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 über die angeschlossenen Geräte 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.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 R2 [nur Desktop-Apps]
Zielplattform Fenster
Header vds.h
Library Uuid.lib
Weiterverteilbar VDS 1.1

Siehe auch

IEnumVdsObject

IVdsIscsiTarget