Metodo IVdsLunControllerPorts::AssociateControllerPorts (vds.h)

Articolo
03/08/2023

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Imposta le porte del controller del sottosistema su attivo o inattivo rispetto al LUN. Questo metodo sostituisce IVdsLun::AssociateControllers.

Sintassi

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

Parametri

pActiveControllerPortIdArray

Puntatore a una matrice di GUID della porta del controller. Il provider imposta queste porte controller su attivo. Questa matrice include le porte del controller già impostate su attivo che devono rimanere attive.

lNumberOfActiveControllerPorts

Numero di porte del controller specificate nel parametro pActiveControllerPortIdArray .

pInactiveControllerPortIdArray

Puntatore a una matrice di GUID della porta del controller. Il provider imposta queste porte controller su inattive. Questa matrice include porte controller già impostate su inattive che devono rimanere inattive.

lNumberOfInactiveControllerPorts

Numero di porte del controller specificate nel parametro pInactiveControllerPortIdArray .

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice/valore restituito	Descrizione
S_OK	Il nome dell'associazione è stato impostato correttamente.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	La cache del provider è danneggiata. Questo indica un problema di comunicazione o software all'interno di un provider che memorizza nella cache le informazioni sui dispositivi collegati. Il chiamante può usare il metodo IVdsHwProvider::Reenumerate seguito dal metodo IVdsHwProvider::Refresh per ripristinare la cache.
VDS_E_OBJECT_DELETED 0x8004240BL	L'oggetto LUN non è più presente.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Il LUN si trova in uno stato di errore e non è in grado di eseguire l'operazione richiesta.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	È in corso un'altra operazione. Questa operazione non può continuare fino al completamento delle operazioni precedenti.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Uno o più GUID del tipo di dati VDS_OBJECT_ID specificati nei parametri pActiveControllerPortIdArray o pInactiveControllerPortIdArray non fanno riferimento a un oggetto esistente.
VDS_E_NOT_SUPPORTED 0x80042400L	Questa operazione o combinazione di parametri non è supportata da questo provider.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vds.h
Componente ridistribuibile	VDS 1.1

Vedi anche

IVdsLunControllerPorts

Condividi tramite