Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]
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
);
Die 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 aktiv sind, die aktiv bleiben sollen.
lNumberOfActiveControllerPorts
Die Anzahl der Controllerports, die im Parameter "pActiveControllerPortIdArray " angegeben sind.
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, die inaktiv bleiben sollen.
lNumberOfInactiveControllerPorts
Die Anzahl der Controllerports, die im Parameter "pInactiveControllerPortIdArray " angegeben sind.
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 |
|---|---|
|
Der Zuordnungsname wurde erfolgreich festgelegt. |
|
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. |
|
Das LUN-Objekt ist nicht mehr vorhanden. |
|
Die LUN befindet sich in einem fehlerhaften Zustand und kann den angeforderten Vorgang nicht ausführen. |
|
Ein weiterer Vorgang wird ausgeführt. Dieser Vorgang kann erst fortgesetzt werden, wenn vorherige Vorgänge abgeschlossen sind. |
|
Mindestens eine GUIDs vom Datentyp VDS_OBJECT_ID , die in den Parametern pActiveControllerPortIdArray oder pInactiveControllerPortIdArray angegeben sind, verweisen nicht auf ein vorhandenes Objekt. |
|
Dieser Vorgang oder eine Kombination von Parametern wird von diesem Anbieter nicht unterstützt. |
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 | vdshwprv.h |
| Weiterverteilbar | VDS 1.1 |