IVdsLunControllerPorts::AssociateControllerPorts-Methode (vds.h)

  • Artikel

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

Legt die Subsystemcontrollerports in Bezug auf die LUN auf aktiv oder inaktiv fest. Diese Methode ersetzt IVdsLun::AssociateControllers.

Syntax

HRESULT AssociateControllerPorts(
  VDS_OBJECT_ID *pActiveControllerPortIdArray,
  LONG          lNumberOfActiveControllerPorts,
  VDS_OBJECT_ID *pInactiveControllerPortIdArray,
  LONG          lNumberOfInactiveControllerPorts
);

Parameter

pActiveControllerPortIdArray

Ein Zeiger auf ein Array von Controllerport-GUIDs. Der Anbieter legt diese Controllerports auf aktiv fest. Dieses Array enthält Controllerports, die bereits auf aktiv festgelegt sind und aktiv bleiben sollen.

lNumberOfActiveControllerPorts

Die Anzahl der Controllerports, die im pActiveControllerPortIdArray-Parameter angegeben ist.

pInactiveControllerPortIdArray

Ein Zeiger auf ein Array von Controllerport-GUIDs. Der Anbieter legt diese Controllerports auf inaktiv fest. Dieses Array enthält Controllerports, die bereits auf inaktiv festgelegt sind und inaktiv bleiben sollen.

lNumberOfInactiveControllerPorts

Die Anzahl der Controllerports, die im pInactiveControllerPortIdArray-Parameter angegeben ist.

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
 Der Zuordnungsname wurde erfolgreich festgelegt.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 Der Cache des Anbieters ist beschädigt. Dies gibt ein Software- oder Kommunikationsproblem innerhalb eines Anbieters an, 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 LUN-Objekt ist nicht mehr vorhanden.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Die LUN 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 die vorherigen Vorgänge abgeschlossen sind.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Mindestens eine GUIDs des Datentyps VDS_OBJECT_ID , die im pActiveControllerPortIdArray - oder pInactiveControllerPortIdArray-Parameter angegeben sind, verweisen nicht auf ein vorhandenes Objekt.
VDS_E_NOT_SUPPORTED
0x80042400L
 Dieser Vorgang oder diese Kombination von Parametern wird von diesem Anbieter nicht unterstützt.

Anforderungen

   
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
Verteilbare Komponente VDS 1.1

Weitere Informationen

IVdsLunControllerPorts