Metodo IVdsLunIscsi::AssociateTargets (vdshwprv.h)

  • Articolo

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

Associa i LUN alle destinazioni iSCSI del sottosistema.

Sintassi

HRESULT AssociateTargets(
  [in] VDS_OBJECT_ID *pTargetIdArray,
  [in] LONG          lNumberOfTargets
);

Parametri

[in] pTargetIdArray

Puntatore a una matrice di tipi di dati VDS_OBJECT_ID di destinazione. Il provider associa queste destinazioni iSCSI al LUN. Questa matrice include destinazioni già associate al LUN che devono rimanere così.

[in] lNumberOfTargets

Numero di destinazioni specificate nel parametro pTargetArray .

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
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 Questo valore restituito segnala un problema di comunicazione o software all'interno di un provider che memorizza nella cache le informazioni sulla matrice. 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
 Un'altra operazione è in corso; questa operazione non può continuare fino al completamento dell'operazione o delle operazioni precedenti.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Può essere restituito da qualsiasi metodo che accetta una costante VDS_OBJECT_ID . Questo valore restituito indica che l'identificatore non fa riferimento a un oggetto esistente.
VDS_E_NOT_SUPPORTED
0x80042400L
 Questa operazione o combinazione di parametri non è supportata da questo provider.

Commenti

La maggior parte dei sottosistemi implementa una sola destinazione associata per LUN, ma alcune consentono più destinazioni associate.

Usare il metodo IVdsLunIscsi::QueryAssociatedTargets per eseguire query sulle associazioni di destinazione. Usare il metodo IVdsIscsiTarget::QueryAssociatedLuns per eseguire una query sui LUN associati a una destinazione.

Requisiti

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

Vedi anche

IVdsLunIscsi

IVdsLunIscsi::QueryAssociatedTargets