IVdsLunControllerPorts::AssociateControllerPorts-Methode (vds.h)

Artikel
03/08/2023

[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

Freigeben über