Metodo IVdsLun::AddPlex (vdshwprv.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.

Aggiunge un LUN alla lun di destinazione come nuovo plex.

Sintassi

HRESULT AddPlex(
  [in]  VDS_OBJECT_ID lunId,
  [out] IVdsAsync     **ppAsync
);

Parametri

[in] lunId

GUID del LUN da aggiungere come plex.

[out] ppAsync

Indirizzo di un puntatore dell'interfaccia IVdsAsync , che il VDS inizializza sul ritorno. I chiamanti devono rilasciare l'interfaccia. Usare questa interfaccia per annullare, attendere o eseguire query sullo stato dell'operazione.

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
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 è in uno stato non riuscito 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	Questa operazione può essere restituita da qualsiasi metodo che accetta una costante VDS_OBJECT_ID . Indica che l'identificatore non fa riferimento a un oggetto esistente.
VDS_E_INVALID_OPERATION 0x80042415L	L'operazione non è valida. In alternativa, il LUN di origine è minore del LUN di destinazione. Se il LUN di origine è maggiore del LUN di destinazione, il LUN di destinazione rimane la stessa dimensione e l'operazione ha esito positivo.

Commenti

Dopo che il chiamante aggiunge il nuovo LUN come plex, non è più visibile come LUN. Se il chiamante
aggiunge un LUN con mirroring, VDS include ogni plex come un plex discreto. Tutti i dati nel LUN aggiunto vengono persi.

Gli implementatori devono restituire un puntatore all'interfaccia IVdsAsync per questo metodo, indipendentemente dal fatto che la chiamata avvia un'operazione asincrona.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vdshwprv.h
Libreria	Uuid.lib

Vedi anche

IVdsAsync

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsLun