Metodo IVdsLunIscsi::AssociateTargets (vds.h)
[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 le 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 di destinazione VDS_OBJECT_ID . 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 derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.
| Codice/valore restituito | Descrizione |
|---|---|
|
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. |
|
L'oggetto LUN non è più presente. |
|
Il LUN è in uno stato non riuscito e non è in grado di eseguire l'operazione richiesta. |
|
Un'altra operazione è in corso; questa operazione non può continuare fino al completamento dell'operazione o delle operazioni precedenti. |
|
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. |
|
Questa operazione o combinazione di parametri non è supportata da questo provider. |
Commenti
La maggior parte dei sottosistemi implementa solo una destinazione associata per LUN, ma alcuni consentono più destinazioni associate.
Usare il metodo IVdsLunIscsi::QueryAssociatedTargets per eseguire query sulle associazioni di destinazione. Usare il metodo IVdsIscsiTarget::QueryAssociatedLuns per eseguire 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 | vds.h |
| Componente ridistribuibile | VDS 1.1 |